WebSVN – HelenOS – Diff – /branches/network/uspace/srv/net/net/net.h


/*
 * 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"
 
/** 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"
 
/** Internet protocol module name.
 */
#define IP_NAME             "ip"
 
/** Internet protocol module full path filename.
 */
#define IP_FILENAME         "/srv/ip"
 
/** 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.
 *  @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( 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.
 *  @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( char * name, netif_ref netif );
 
#endif
 
/** @}
 */
 

Subversion Repositories HelenOS

(root)/branches/network/uspace/srv/net/net/net.h – Rev 4351 → 4696

Rev 4351		Rev 4696
1	/*	1	/*
2	* Copyright (c) 2009 Lukas Mejdrech	2	* Copyright (c) 2009 Lukas Mejdrech
3	* All rights reserved.	3	* All rights reserved.
4	*	4	*
5	* Redistribution and use in source and binary forms, with or without	5	* Redistribution and use in source and binary forms, with or without
6	* modification, are permitted provided that the following conditions	6	* modification, are permitted provided that the following conditions
7	* are met:	7	* are met:
8	*	8	*
9	* - Redistributions of source code must retain the above copyright	9	* - Redistributions of source code must retain the above copyright
10	* notice, this list of conditions and the following disclaimer.	10	* notice, this list of conditions and the following disclaimer.
11	* - Redistributions in binary form must reproduce the above copyright	11	* - Redistributions in binary form must reproduce the above copyright
12	* notice, this list of conditions and the following disclaimer in the	12	* notice, this list of conditions and the following disclaimer in the
13	* documentation and/or other materials provided with the distribution.	13	* documentation and/or other materials provided with the distribution.
14	* - The name of the author may not be used to endorse or promote products	14	* - The name of the author may not be used to endorse or promote products
15	* derived from this software without specific prior written permission.	15	* derived from this software without specific prior written permission.
16	*	16	*
17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR	17	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES	18	* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.	19	* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,	20	* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT	21	* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,	22	* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY	23	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT	24	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF	25	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.	26	* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27	*/	27	*/
28		28
29	/** @addtogroup net	29	/** @addtogroup net
30	* @{	30	* @{
31	*/	31	*/
32		32
33	/** @file	33	/** @file
34	* Networking subsystem central module.	34	* Networking subsystem central module.
35	*/	35	*/
36		36
37	#ifndef __NET_NET_H__	37	#ifndef __NET_NET_H__
38	#define __NET_NET_H__	38	#define __NET_NET_H__
39		39
40	#include <ipc/ipc.h>	40	#include <ipc/ipc.h>
41		41
42	#include "../include/device.h"	42	#include "../include/device.h"
43		43
44	#include "../structures/char_map.h"	44	#include "../structures/char_map.h"
45	#include "../structures/generic_char_map.h"	45	#include "../structures/generic_char_map.h"
46	#include "../structures/measured_strings.h"	46	#include "../structures/measured_strings.h"
47	#include "../structures/module_map.h"	47	#include "../structures/module_map.h"
48	#include "../structures/packet/packet.h"	48	#include "../structures/packet/packet.h"
49		49
50	/** Loopback network interface module name.	50	/** Loopback network interface module name.
51	*/	51	*/
52	#define LO_NAME "lo"	52	#define LO_NAME "lo"
53		53
54	/** Loopback network interface module full path filename.	54	/** Loopback network interface module full path filename.
55	*/	55	*/
56	#define LO_FILENAME "/srv/lo"	56	#define LO_FILENAME "/srv/lo"
57		57
58	/** DP8390 network interface module name.	58	/** DP8390 network interface module name.
59	*/	59	*/
60	#define DP8390_NAME "dp8390"	60	#define DP8390_NAME "dp8390"
61		61
62	/** DP8390 network interface module full path filename.	62	/** DP8390 network interface module full path filename.
63	*/	63	*/
64	#define DP8390_FILENAME "/srv/dp8390"	64	#define DP8390_FILENAME "/srv/dp8390"
65		65
66	/** Ethernet module name.	66	/** Ethernet module name.
67	*/	67	*/
68	#define ETHERNET_NAME "ethernet"	68	#define ETHERNET_NAME "ethernet"
69		69
70	/** Ethernet module full path filename.	70	/** Ethernet module full path filename.
71	*/	71	*/
72	#define ETHERNET_FILENAME "/srv/eth"	72	#define ETHERNET_FILENAME "/srv/eth"
73		73
-		74	/** Ethernet module name.
-		75	*/
-		76	#define NILDUMMY_NAME "nildummy"
-		77
-		78	/** Ethernet module full path filename.
-		79	*/
-		80	#define NILDUMMY_FILENAME "/srv/nildummy"
-		81
74	/** Internet protocol module name.	82	/** Internet protocol module name.
75	*/	83	*/
76	#define IP_NAME "ip"	84	#define IP_NAME "ip"
77		85
78	/** Internet protocol module full path filename.	86	/** Internet protocol module full path filename.
79	*/	87	*/
80	#define IP_FILENAME "/srv/ip"	88	#define IP_FILENAME "/srv/ip"
81		89
82	/** Network interface name configuration label.	90	/** Network interface name configuration label.
83	*/	91	*/
84	#define CONF_NAME "NAME"	92	#define CONF_NAME "NAME"
85		93
86	/** Network interface module name configuration label.	94	/** Network interface module name configuration label.
87	*/	95	*/
88	#define CONF_NETIF "NETIF"	96	#define CONF_NETIF "NETIF"
89		97
90	/** Network interface layer module name configuration label.	98	/** Network interface layer module name configuration label.
91	*/	99	*/
92	#define CONF_NIL "NIL"	100	#define CONF_NIL "NIL"
93		101
94	/** Internet protocol module name configuration label.	102	/** Internet protocol module name configuration label.
95	*/	103	*/
96	#define CONF_IL "IL"	104	#define CONF_IL "IL"
97		105
98	/** Interrupt number configuration label.	106	/** Interrupt number configuration label.
99	*/	107	*/
100	#define CONF_IRQ "IRQ"	108	#define CONF_IRQ "IRQ"
101		109
102	/** Device input/output address configuration label.	110	/** Device input/output address configuration label.
103	*/	111	*/
104	#define CONF_IO "IO"	112	#define CONF_IO "IO"
105		113
106	/** Maximum transmission unit configuration label.	114	/** Maximum transmission unit configuration label.
107	*/	115	*/
108	#define CONF_MTU "MTU"	116	#define CONF_MTU "MTU"
109		117
110	/** Type definition of the network interface specific data.	118	/** Type definition of the network interface specific data.
111	* @see netif	119	* @see netif
112	*/	120	*/
113	typedef struct netif netif_t;	121	typedef struct netif netif_t;
114		122
115	/** Type definition of the network interface specific data pointer.	123	/** Type definition of the network interface specific data pointer.
116	* @see netif	124	* @see netif
117	*/	125	*/
118	typedef netif_t * netif_ref;	126	typedef netif_t * netif_ref;
119		127
120	/** Type definition of the networking module global data.	128	/** Type definition of the networking module global data.
121	* @see net_globals	129	* @see net_globals
122	*/	130	*/
123	typedef struct net_globals net_globals_t;	131	typedef struct net_globals net_globals_t;
124		132
125	/** Present network interfaces.	133	/** Present network interfaces.
126	* Maps devices to the networking device specific data.	134	* Maps devices to the networking device specific data.
127	* @see device.h	135	* @see device.h
128	*/	136	*/
129	DEVICE_MAP_DECLARE( netifs, netif_t )	137	DEVICE_MAP_DECLARE( netifs, netif_t )
130		138
131	/** Configuration settings.	139	/** Configuration settings.
132	* Maps setting names to the values.	140	* Maps setting names to the values.
133	* @see generic_char_map.h	141	* @see generic_char_map.h
134	*/	142	*/
135	GENERIC_CHAR_MAP_DECLARE( measured_strings, measured_string_t )	143	GENERIC_CHAR_MAP_DECLARE( measured_strings, measured_string_t )
136		144
137	/** Present network interface device.	145	/** Present network interface device.
138	*/	146	*/
139	struct netif{	147	struct netif{
140	/** System-unique network interface identifier.	148	/** System-unique network interface identifier.
141	*/	149	*/
142	device_id_t id;	150	device_id_t id;
143	/** Serving network interface driver module index.	151	/** Serving network interface driver module index.
144	*/	152	*/
145	module_ref driver;	153	module_ref driver;
146	/** Serving link layer module index.	154	/** Serving link layer module index.
147	*/	155	*/
148	module_ref nil;	156	module_ref nil;
149	/** Serving internet layer module index.	157	/** Serving internet layer module index.
150	*/	158	*/
151	module_ref il;	159	module_ref il;
152	/** System-unique network interface name.	160	/** System-unique network interface name.
153	*/	161	*/
154	char * name;	162	char * name;
155	/** Configuration.	163	/** Configuration.
156	*/	164	*/
157	measured_strings_t configuration;	165	measured_strings_t configuration;
158	};	166	};
159		167
160	/** Networking module global variables.	168	/** Networking module global variables.
161	*/	169	*/
162	struct net_globals{	170	struct net_globals{
163	/** Present network interfaces.	171	/** Present network interfaces.
164	*/	172	*/
165	netifs_t netifs;	173	netifs_t netifs;
166	/** Network interface structure indices by names.	174	/** Network interface structure indices by names.
167	*/	175	*/
168	char_map_t netif_names;	176	char_map_t netif_names;
169	/** Available modules.	177	/** Available modules.
170	*/	178	*/
171	modules_t modules;	179	modules_t modules;
172	/** Global configuration.	180	/** Global configuration.
173	*/	181	*/
174	measured_strings_t configuration;	182	measured_strings_t configuration;
175	};	183	};
176		184
177	/** Adds the configured setting to the configuration map.	185	/** Adds the configured setting to the configuration map.
178	* @param configuration The configuration map. Input parameter.	186	* @param configuration The configuration map. Input parameter.
179	* @param name The setting name. Input parameter.	187	* @param name The setting name. Input parameter.
180	* @param value The setting value. Input parameter.	188	* @param value The setting value. Input parameter.
181	* @returns EOK on success.	189	* @returns EOK on success.
182	* @returns ENOMEM if there is not enough memory left.	190	* @returns ENOMEM if there is not enough memory left.
183	*/	191	*/
184	int add_configuration( measured_strings_ref configuration, const char * name, const char * value );	192	int add_configuration( measured_strings_ref configuration, const char * name, const char * value );
185		193
186	/** Processes the networking message.	194	/** Processes the networking message.
187	* @param callid The message identifier. Input parameter.	195	* @param callid The message identifier. Input parameter.
188	* @param call The message parameters. Input parameter.	196	* @param call The message parameters. Input parameter.
189	* @param answer The message answer parameters. Output parameter.	197	* @param answer The message answer parameters. Output parameter.
190	* @param answer_count The last parameter for the actual answer in the answer parameter. Output parameter.	198	* @param answer_count The last parameter for the actual answer in the answer parameter. Output parameter.
191	* @returns EOK on success.	199	* @returns EOK on success.
192	* @returns ENOTSUP if the message is not known.	200	* @returns ENOTSUP if the message is not known.
193	* @see net_interface.h	201	* @see net_interface.h
194	* @see IS_NET_NET_MESSAGE()	202	* @see IS_NET_NET_MESSAGE()
195	*/	203	*/
196	int net_message( ipc_callid_t callid, ipc_call_t * call, ipc_call_t * answer, int * answer_count );	204	int net_message( ipc_callid_t callid, ipc_call_t * call, ipc_call_t * answer, int * answer_count );
197		205
198	/** Initializes the networking module.	206	/** Initializes the networking module.
199	* @param client_connection The client connection processing function. The module skeleton propagates its own one. Input parameter.	207	* @param client_connection The client connection processing function. The module skeleton propagates its own one. Input parameter.
200	* @returns EOK on success.	208	* @returns EOK on success.
201	* @returns ENOMEM if there is not enough memory left.	209	* @returns ENOMEM if there is not enough memory left.
202	*/	210	*/
203	int net_initialize( async_client_conn_t client_connection );	211	int net_initialize( async_client_conn_t client_connection );
204		212
205	/** Processes the module message.	213	/** Processes the module message.
206	* Distributes the message to the right bundled module.	214	* Distributes the message to the right bundled module.
207	* @param callid The message identifier. Input parameter.	215	* @param callid The message identifier. Input parameter.
208	* @param call The message parameters. Input parameter.	216	* @param call The message parameters. Input parameter.
209	* @param answer The message answer parameters. Output parameter.	217	* @param answer The message answer parameters. Output parameter.
210	* @param answer_count The last parameter for the actual answer in the answer parameter. Output parameter.	218	* @param answer_count The last parameter for the actual answer in the answer parameter. Output parameter.
211	* @returns EOK on success.	219	* @returns EOK on success.
212	* @returns ENOTSUP if the message is not known.	220	* @returns ENOTSUP if the message is not known.
213	* @returns Other error codes as defined for each bundled module message function.	221	* @returns Other error codes as defined for each bundled module message function.
214	*/	222	*/
215	int module_message( ipc_callid_t callid, ipc_call_t * call, ipc_call_t * answer, int * answer_count );	223	int module_message( ipc_callid_t callid, ipc_call_t * call, ipc_call_t * answer, int * answer_count );
216		224
217	/** Reads the network interface specific configuration.	225	/** Reads the network interface specific configuration.
218	* @param name The network interface name. Input parameter.	226	* @param name The network interface name. Input parameter.
219	* @param netif The network interface structure. Input/output parameter.	227	* @param netif The network interface structure. Input/output parameter.
220	* @returns EOK on success.	228	* @returns EOK on success.
221	* @returns Other error codes as defined for the add_configuration() function.	229	* @returns Other error codes as defined for the add_configuration() function.
222	*/	230	*/
223	int read_netif_configuration( char * name, netif_ref netif );	231	int read_netif_configuration( char * name, netif_ref netif );
224		232
225	#endif	233	#endif
226		234
227	/** @}	235	/** @}
228	*/	236	*/
229		237