Subversion Repositories HelenOS

Rev

Rev 4351 | Rev 4704 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

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