/*
* 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 net
* @{
*/
/** @file
* Networking subsystem central module.
*/
#ifndef __NET_NET_H__
#define __NET_NET_H__
#include <ipc/ipc.h>
#include "../include/device.h"
#include "../structures/char_map.h"
#include "../structures/generic_char_map.h"
#include "../structures/measured_strings.h"
#include "../structures/module_map.h"
#include "../structures/packet/packet.h"
/** @name Modules definitions
*/
/*@{*/
/** Loopback network interface module name.
*/
#define LO_NAME "lo"
/** Loopback network interface module full path filename.
*/
#define LO_FILENAME "/srv/lo"
/** DP8390 network interface module name.
*/
#define DP8390_NAME "dp8390"
/** DP8390 network interface module full path filename.
*/
#define DP8390_FILENAME "/srv/dp8390"
/** Ethernet module name.
*/
#define ETHERNET_NAME "ethernet"
/** Ethernet module full path filename.
*/
#define ETHERNET_FILENAME "/srv/eth"
/** Ethernet module name.
*/
#define NILDUMMY_NAME "nildummy"
/** Ethernet module full path filename.
*/
#define NILDUMMY_FILENAME "/srv/nildummy"
/** IP module name.
*/
#define IP_NAME "ip"
/** IP module full path filename.
*/
#define IP_FILENAME "/srv/ip"
/*@}*/
/** @name Configuration setting names definitions
*/
/*@{*/
/** Network interface name configuration label.
*/
#define CONF_NAME "NAME"
/** Network interface module name configuration label.
*/
#define CONF_NETIF "NETIF"
/** Network interface layer module name configuration label.
*/
#define CONF_NIL "NIL"
/** Internet protocol module name configuration label.
*/
#define CONF_IL "IL"
/** Interrupt number configuration label.
*/
#define CONF_IRQ "IRQ"
/** Device input/output address configuration label.
*/
#define CONF_IO "IO"
/** Maximum transmission unit configuration label.
*/
#define CONF_MTU "MTU"
/*@}*/
/** Type definition of the network interface specific data.
* @see netif
*/
typedef struct netif netif_t;
/** Type definition of the network interface specific data pointer.
* @see netif
*/
typedef netif_t * netif_ref;
/** Type definition of the networking module global data.
* @see net_globals
*/
typedef struct net_globals net_globals_t;
/** Present network interfaces.
* Maps devices to the networking device specific data.
* @see device.h
*/
DEVICE_MAP_DECLARE( netifs, netif_t )
/** Configuration settings.
* Maps setting names to the values.
* @see generic_char_map.h
*/
GENERIC_CHAR_MAP_DECLARE( measured_strings, measured_string_t )
/** Present network interface device.
*/
struct netif{
/** System-unique network interface identifier.
*/
device_id_t id;
/** Serving network interface driver module index.
*/
module_ref driver;
/** Serving link layer module index.
*/
module_ref nil;
/** Serving internet layer module index.
*/
module_ref il;
/** System-unique network interface name.
*/
char * name;
/** Configuration.
*/
measured_strings_t configuration;
};
/** Networking module global variables.
*/
struct net_globals{
/** Present network interfaces.
*/
netifs_t netifs;
/** Network interface structure indices by names.
*/
char_map_t netif_names;
/** Available modules.
*/
modules_t modules;
/** Global configuration.
*/
measured_strings_t configuration;
};
/** Adds the configured setting to the configuration map.
* @param configuration The configuration map. Input parameter.
* @param name The setting name. Input parameter.
* @param value The setting value. Input parameter.
* @returns EOK on success.
* @returns ENOMEM if there is not enough memory left.
*/
int add_configuration( measured_strings_ref configuration, const char * name, const char * value );
/** Processes the networking message.
* @param callid The message identifier. Input parameter.
* @param call The message parameters. Input parameter.
* @param answer The message answer parameters. Output parameter.
* @param answer_count The last parameter for the actual answer in the answer parameter. Output parameter.
* @returns EOK on success.
* @returns ENOTSUP if the message is not known.
* @see net_interface.h
* @see IS_NET_NET_MESSAGE()
*/
int net_message( ipc_callid_t callid, ipc_call_t * call, ipc_call_t * answer, int * answer_count );
/** Initializes the networking module for the chosen subsystem build type.
* @param client_connection The client connection processing function. The module skeleton propagates its own one. Input parameter.
* @returns EOK on success.
* @returns ENOMEM if there is not enough memory left.
*/
int net_initialize_build( async_client_conn_t client_connection );
/** Processes the module message.
* Distributes the message to the right bundled module.
* @param callid The message identifier. Input parameter.
* @param call The message parameters. Input parameter.
* @param answer The message answer parameters. Output parameter.
* @param answer_count The last parameter for the actual answer in the answer parameter. Output parameter.
* @returns EOK on success.
* @returns ENOTSUP if the message is not known.
* @returns Other error codes as defined for each bundled module message function.
*/
int module_message( ipc_callid_t callid, ipc_call_t * call, ipc_call_t * answer, int * answer_count );
/** Reads the network interface specific configuration for the chosen subsystem build type.
* @param name The network interface name. Input parameter.
* @param netif The network interface structure. Input/output parameter.
* @returns EOK on success.
* @returns Other error codes as defined for the add_configuration() function.
*/
int read_netif_configuration_build( char * name, netif_ref netif );
#endif
/** @}
*/