source: mainline/uspace/lib/net/generic/packet_remote.c@ 00b6c73

/*
 * Copyright (c) 2009 Lukas Mejdrech
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/** @addtogroup libnet
 * @{
 */

/** @file
 * Packet client interface implementation for remote modules.
 * @see packet_client.h
 */

#include <async.h>
#include <errno.h>
#include <ipc/packet.h>
#include <sys/mman.h>

#include <packet_client.h>
#include <packet_remote.h>

#include <net/packet.h>
#include <net/packet_header.h>

/** Obtain the packet from the packet server as the shared memory block.
 *
 * Create the local packet mapping as well.
 *
 * @param[in]  phone     The packet server module phone.
 * @param[out] packet    The packet reference pointer to store the received
 *                       packet reference.
 * @param[in]  packet_id The packet identifier.
 * @param[in]  size      The packet total size in bytes.
 *
 * @return EOK on success.
 * @return Other error codes as defined for the pm_add() function.
 * @return Other error codes as defined for the async_share_in_start() function.
 *
 */
static int
packet_return(int phone, packet_t **packet, packet_id_t packet_id, size_t size)
{
        ipc_call_t answer;
        aid_t message;
        int rc;
        
        message = async_send_1(phone, NET_PACKET_GET, packet_id, &answer);

        *packet = (packet_t *) as_get_mappable_page(size);
        rc = async_share_in_start_0_0(phone, *packet, size);
        if (rc != EOK) {
                munmap(*packet, size);
                async_wait_for(message, NULL);
                return rc;
        }
        rc = pm_add(*packet);
        if (rc != EOK) {
                munmap(*packet, size);
                async_wait_for(message, NULL);
                return rc;
        }
        
        sysarg_t result;
        async_wait_for(message, &result);
        
        return result;
}

/** Translates the packet identifier to the packet reference.
 *
 * Tries to find mapping first.
 * Contacts the packet server to share the packet if the mapping is not present.
 *
 * @param[in] phone     The packet server module phone.
 * @param[out] packet   The packet reference.
 * @param[in] packet_id The packet identifier.
 * @return              EOK on success.
 * @return              EINVAL if the packet parameter is NULL.
 * @return              Other error codes as defined for the NET_PACKET_GET_SIZE
 *                      message.
 * @return              Other error codes as defined for the packet_return()
 *                      function.
 */
int packet_translate_remote(int phone, packet_t **packet, packet_id_t packet_id)
{
        int rc;
        
        if (!packet)
                return EINVAL;
        
        *packet = pm_find(packet_id);
        if (!*packet) {
                sysarg_t size;
                
                rc = async_req_1_1(phone, NET_PACKET_GET_SIZE, packet_id,
                    &size);
                if (rc != EOK)
                        return rc;
                rc = packet_return(phone, packet, packet_id, size);
                if (rc != EOK)
                        return rc;
        }
        if ((*packet)->next) {
                packet_t *next;
                
                return packet_translate_remote(phone, &next, (*packet)->next);
        }
        
        return EOK;
}

/** Obtains the packet of the given dimensions.
 *
 * Contacts the packet server to return the appropriate packet.
 *
 * @param[in] phone     The packet server module phone.
 * @param[in] addr_len  The source and destination addresses maximal length in
 *                      bytes.
 * @param[in] max_prefix The maximal prefix length in bytes.
 * @param[in] max_content The maximal content length in bytes.
 * @param[in] max_suffix The maximal suffix length in bytes.
 * @return              The packet reference.
 * @return              NULL on error.
 */
packet_t *packet_get_4_remote(int phone, size_t max_content, size_t addr_len,
    size_t max_prefix, size_t max_suffix)
{
        sysarg_t packet_id;
        sysarg_t size;
        int rc;
        
        rc = async_req_4_2(phone, NET_PACKET_CREATE_4, max_content, addr_len,
            max_prefix, max_suffix, &packet_id, &size);
        if (rc != EOK)
                return NULL;
        
        
        packet_t *packet = pm_find(packet_id);
        if (!packet) {
                rc = packet_return(phone, &packet, packet_id, size);
                if (rc != EOK)
                        return NULL;
        }
        
        return packet;
}

/** Obtains the packet of the given content size.
 *
 * Contacts the packet server to return the appropriate packet.
 *
 * @param[in] phone     The packet server module phone.
 * @param[in] content   The maximal content length in bytes.
 * @return              The packet reference.
 * @return              NULL on error.
 */
packet_t *packet_get_1_remote(int phone, size_t content)
{
        sysarg_t packet_id;
        sysarg_t size;
        int rc;
        
        rc = async_req_1_2(phone, NET_PACKET_CREATE_1, content, &packet_id,
            &size);
        if (rc != EOK)
                return NULL;
        
        packet_t *packet = pm_find(packet_id);
        if (!packet) {
                rc = packet_return(phone, &packet, packet_id, size);
                if (rc != EOK)
                        return NULL;
        }
        
        return packet;
}

/** Releases the packet queue.
 *
 * All packets in the queue are marked as free for use.
 * The packet queue may be one packet only.
 * The module should not use the packets after this point until they are
 * received or obtained again.
 *
 * @param[in] phone     The packet server module phone.
 * @param[in] packet_id The packet identifier.
 */
void pq_release_remote(int phone, packet_id_t packet_id)
{
        async_msg_1(phone, NET_PACKET_RELEASE, packet_id);
}

/** @}
 */