| /* |
| * Copyright (c) 2001-2004 Swedish Institute of Computer Science. |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without modification, |
| * are permitted provided that the following conditions are met: |
| * |
| * 1. Redistributions of source code must retain the above copyright notice, |
| * this list of conditions and the following disclaimer. |
| * 2. 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. |
| * 3. 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. |
| * |
| * This file is part of the lwIP TCP/IP stack. |
| * |
| * Author: Adam Dunkels <adam@sics.se> |
| * |
| */ |
| #ifndef __LWIP_NETIF_H__ |
| #define __LWIP_NETIF_H__ |
| |
| #include "lwip/opt.h" |
| |
| #define ENABLE_LOOPBACK (LWIP_NETIF_LOOPBACK || LWIP_HAVE_LOOPIF) |
| |
| #include "lwip/err.h" |
| |
| #include "lwip/ip_addr.h" |
| #include "lwip/ip6_addr.h" |
| |
| #include "lwip/def.h" |
| #include "lwip/pbuf.h" |
| #if LWIP_DHCP |
| struct dhcp; |
| #endif |
| #if LWIP_AUTOIP |
| struct autoip; |
| #endif |
| #if LWIP_IPV6_DHCP6 |
| #include "lwip/dhcp6.h" |
| #endif /* LWIP_IPV6_DHCP6 */ |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /* Throughout this file, IP addresses are expected to be in |
| * the same byte order as in IP_PCB. */ |
| |
| /** must be the maximum of all used hardware address lengths |
| across all types of interfaces in use */ |
| #ifndef NETIF_MAX_HWADDR_LEN |
| #define NETIF_MAX_HWADDR_LEN 6U |
| #endif /* NETIF_MAX_HWADDR_LEN */ |
| |
| /** Whether the network interface is 'up'. This is |
| * a software flag used to control whether this network |
| * interface is enabled and processes traffic. |
| * It is set by the startup code (for static IP configuration) or |
| * by dhcp/autoip when an address has been assigned. |
| */ |
| #define NETIF_FLAG_UP 0x01U |
| /** If set, the netif has broadcast capability. |
| * Set by the netif driver in its init function. */ |
| #define NETIF_FLAG_BROADCAST 0x02U |
| /** If set, the netif is one end of a point-to-point connection. |
| * Set by the netif driver in its init function. */ |
| #define NETIF_FLAG_POINTTOPOINT 0x04U |
| /** If set, the interface is configured using DHCP. |
| * Set by the DHCP code when starting or stopping DHCP. */ |
| #define NETIF_FLAG_DHCP 0x08U |
| /** If set, the interface has an active link |
| * (set by the network interface driver). |
| * Either set by the netif driver in its init function (if the link |
| * is up at that time) or at a later point once the link comes up |
| * (if link detection is supported by the hardware). */ |
| #define NETIF_FLAG_LINK_UP 0x10U |
| /** If set, the netif is an ethernet device using ARP. |
| * Set by the netif driver in its init function. |
| * Used to check input packet types and use of DHCP. */ |
| #define NETIF_FLAG_ETHARP 0x20U |
| /** If set, the netif is an ethernet device. It might not use |
| * ARP or TCP/IP if it is used for PPPoE only. |
| */ |
| #define NETIF_FLAG_ETHERNET 0x40U |
| /** If set, the netif has IGMP capability. |
| * Set by the netif driver in its init function. */ |
| #define NETIF_FLAG_IGMP 0x80U |
| |
| /** Function prototype for netif init functions. Set up flags and output/linkoutput |
| * callback functions in this function. |
| * |
| * @param netif The netif to initialize |
| */ |
| typedef err_t (*netif_init_fn)(struct netif *netif); |
| /** Function prototype for netif->input functions. This function is saved as 'input' |
| * callback function in the netif struct. Call it when a packet has been received. |
| * |
| * @param p The received packet, copied into a pbuf |
| * @param inp The netif which received the packet |
| */ |
| typedef err_t (*netif_input_fn)(struct pbuf *p, struct netif *inp); |
| /** Function prototype for netif->output functions. Called by lwIP when a packet |
| * shall be sent. For ethernet netif, set this to 'etharp_output' and set |
| * 'linkoutput'. |
| * |
| * @param netif The netif which shall send a packet |
| * @param p The packet to send (p->payload points to IP header) |
| * @param ipaddr The IP address to which the packet shall be sent |
| */ |
| typedef err_t (*netif_output_fn)(struct netif *netif, struct pbuf *p, |
| ip_addr_t *ipaddr); |
| #if LWIP_IPV6 |
| /** Function prototype for netif->output_ip6 functions. Called by lwIP when a packet |
| * shall be sent. For ethernet netif, set this to 'nd_output' and set |
| * 'linkoutput'. |
| * |
| * @param netif The netif which shall send a packet |
| * @param p The packet to send (p->payload points to IP header) |
| * @param ipaddr The IPv6 address to which the packet shall be sent |
| */ |
| typedef err_t (*netif_output_ip6_fn)(struct netif *netif, struct pbuf *p, |
| ip6_addr_t *ipaddr); |
| #endif /* LWIP_IPV6 */ |
| /** Function prototype for netif->linkoutput functions. Only used for ethernet |
| * netifs. This function is called by ARP when a packet shall be sent. |
| * |
| * @param netif The netif which shall send a packet |
| * @param p The packet to send (raw ethernet packet) |
| */ |
| typedef err_t (*netif_linkoutput_fn)(struct netif *netif, struct pbuf *p); |
| /** Function prototype for netif status- or link-callback functions. */ |
| typedef void (*netif_status_callback_fn)(struct netif *netif); |
| /** Function prototype for netif igmp_mac_filter functions */ |
| typedef err_t (*netif_igmp_mac_filter_fn)(struct netif *netif, |
| ip_addr_t *group, u8_t action); |
| #if LWIP_IPV6 && LWIP_IPV6_MLD |
| /** Function prototype for netif mld_mac_filter functions */ |
| typedef err_t (*netif_mld_mac_filter_fn)(struct netif *netif, |
| ip6_addr_t *group, u8_t action); |
| #endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ |
| |
| /** Generic data structure used for all lwIP network interfaces. |
| * The following fields should be filled in by the initialization |
| * function for the device driver: hwaddr_len, hwaddr[], mtu, flags */ |
| struct netif { |
| /** pointer to next in linked list */ |
| struct netif *next; |
| |
| /** IP address configuration in network byte order */ |
| ip_addr_t ip_addr; |
| ip_addr_t netmask; |
| ip_addr_t gw; |
| |
| #if LWIP_IPV6 |
| /** Array of IPv6 addresses for this netif. */ |
| ip6_addr_t ip6_addr[LWIP_IPV6_NUM_ADDRESSES]; |
| /** The state of each IPv6 address (Tentative, Preferred, etc). |
| * @see ip6_addr.h */ |
| u8_t ip6_addr_state[LWIP_IPV6_NUM_ADDRESSES]; |
| #endif /* LWIP_IPV6 */ |
| /** This function is called by the network device driver |
| * to pass a packet up the TCP/IP stack. */ |
| netif_input_fn input; |
| /** This function is called by the IP module when it wants |
| * to send a packet on the interface. This function typically |
| * first resolves the hardware address, then sends the packet. */ |
| netif_output_fn output; |
| /** This function is called by the ARP module when it wants |
| * to send a packet on the interface. This function outputs |
| * the pbuf as-is on the link medium. */ |
| netif_linkoutput_fn linkoutput; |
| #if LWIP_IPV6 |
| /** This function is called by the IPv6 module when it wants |
| * to send a packet on the interface. This function typically |
| * first resolves the hardware address, then sends the packet. */ |
| netif_output_ip6_fn output_ip6; |
| #endif /* LWIP_IPV6 */ |
| #if LWIP_NETIF_STATUS_CALLBACK |
| /** This function is called when the netif state is set to up or down |
| */ |
| netif_status_callback_fn status_callback; |
| #endif /* LWIP_NETIF_STATUS_CALLBACK */ |
| #if LWIP_NETIF_LINK_CALLBACK |
| /** This function is called when the netif link is set to up or down |
| */ |
| netif_status_callback_fn link_callback; |
| #endif /* LWIP_NETIF_LINK_CALLBACK */ |
| #if LWIP_NETIF_REMOVE_CALLBACK |
| /** This function is called when the netif has been removed */ |
| netif_status_callback_fn remove_callback; |
| #endif /* LWIP_NETIF_REMOVE_CALLBACK */ |
| /** This field can be set by the device driver and could point |
| * to state information for the device. */ |
| void *state; |
| #if LWIP_DHCP |
| /** the DHCP client state information for this netif */ |
| struct dhcp *dhcp; |
| #endif /* LWIP_DHCP */ |
| #if LWIP_AUTOIP |
| /** the AutoIP client state information for this netif */ |
| struct autoip *autoip; |
| #endif |
| #if LWIP_IPV6_AUTOCONFIG |
| /** is this netif enabled for IPv6 autoconfiguration */ |
| u8_t ip6_autoconfig_enabled; |
| #endif /* LWIP_IPV6_AUTOCONFIG */ |
| #if LWIP_IPV6_SEND_ROUTER_SOLICIT |
| /** Number of Router Solicitation messages that remain to be sent. */ |
| u8_t rs_count; |
| #endif /* LWIP_IPV6_SEND_ROUTER_SOLICIT */ |
| #if LWIP_IPV6_DHCP6 |
| /** the DHCPv6 client state information for this netif */ |
| struct dhcp6 *dhcp6; |
| #endif /* LWIP_IPV6_DHCP6 */ |
| #if LWIP_NETIF_HOSTNAME |
| /* the hostname for this netif, NULL is a valid value */ |
| char* hostname; |
| #endif /* LWIP_NETIF_HOSTNAME */ |
| /** maximum transfer unit (in bytes) */ |
| u16_t mtu; |
| /** number of bytes used in hwaddr */ |
| u8_t hwaddr_len; |
| /** link level hardware address of this interface */ |
| u8_t hwaddr[NETIF_MAX_HWADDR_LEN]; |
| /** flags (see NETIF_FLAG_ above) */ |
| u8_t flags; |
| #if LWIP_MANAGEMENT_CHANNEL |
| u8_t using_management_channel:1; |
| #endif |
| /** descriptive abbreviation */ |
| char name[2]; |
| /** number of this interface */ |
| u8_t num; |
| #if LWIP_SNMP |
| /** link type (from "snmp_ifType" enum from snmp.h) */ |
| u8_t link_type; |
| /** (estimate) link speed */ |
| u32_t link_speed; |
| /** timestamp at last change made (up/down) */ |
| u32_t ts; |
| /** counters */ |
| u32_t ifinoctets; |
| u32_t ifinucastpkts; |
| u32_t ifinnucastpkts; |
| u32_t ifindiscards; |
| u32_t ifoutoctets; |
| u32_t ifoutucastpkts; |
| u32_t ifoutnucastpkts; |
| u32_t ifoutdiscards; |
| #endif /* LWIP_SNMP */ |
| #if LWIP_IGMP |
| /** This function could be called to add or delete an entry in the multicast |
| filter table of the ethernet MAC.*/ |
| netif_igmp_mac_filter_fn igmp_mac_filter; |
| #endif /* LWIP_IGMP */ |
| #if LWIP_IPV6 && LWIP_IPV6_MLD |
| /** This function could be called to add or delete an entry in the IPv6 multicast |
| filter table of the ethernet MAC. */ |
| netif_mld_mac_filter_fn mld_mac_filter; |
| #endif /* LWIP_IPV6 && LWIP_IPV6_MLD */ |
| #if LWIP_NETIF_HWADDRHINT |
| u8_t *addr_hint; |
| #endif /* LWIP_NETIF_HWADDRHINT */ |
| #if ENABLE_LOOPBACK |
| /* List of packets to be queued for ourselves. */ |
| struct pbuf *loop_first; |
| struct pbuf *loop_last; |
| #if LWIP_LOOPBACK_MAX_PBUFS |
| u16_t loop_cnt_current; |
| #endif /* LWIP_LOOPBACK_MAX_PBUFS */ |
| #endif /* ENABLE_LOOPBACK */ |
| }; |
| |
| #if LWIP_SNMP |
| #define NETIF_INIT_SNMP(netif, type, speed) \ |
| /* use "snmp_ifType" enum from snmp.h for "type", snmp_ifType_ethernet_csmacd by example */ \ |
| (netif)->link_type = (type); \ |
| /* your link speed here (units: bits per second) */ \ |
| (netif)->link_speed = (speed); \ |
| (netif)->ts = 0; \ |
| (netif)->ifinoctets = 0; \ |
| (netif)->ifinucastpkts = 0; \ |
| (netif)->ifinnucastpkts = 0; \ |
| (netif)->ifindiscards = 0; \ |
| (netif)->ifoutoctets = 0; \ |
| (netif)->ifoutucastpkts = 0; \ |
| (netif)->ifoutnucastpkts = 0; \ |
| (netif)->ifoutdiscards = 0 |
| #else /* LWIP_SNMP */ |
| #define NETIF_INIT_SNMP(netif, type, speed) |
| #endif /* LWIP_SNMP */ |
| |
| |
| /** The list of network interfaces. */ |
| extern struct netif *netif_list; |
| /** The default network interface. */ |
| extern struct netif *netif_default; |
| |
| void netif_init(void); |
| |
| struct ip_pcb; |
| |
| void netif_apply_pcb(struct netif *netif, struct ip_pcb *pcb); |
| |
| struct netif *netif_add(struct netif *netif, ip_addr_t *ipaddr, ip_addr_t *netmask, |
| ip_addr_t *gw, void *state, netif_init_fn init, netif_input_fn input); |
| |
| void |
| netif_set_addr(struct netif *netif, ip_addr_t *ipaddr, ip_addr_t *netmask, |
| ip_addr_t *gw); |
| void netif_remove(struct netif * netif); |
| |
| /* Returns a network interface given its name. The name is of the form |
| "et0", where the first two letters are the "name" field in the |
| netif structure, and the digit is in the num field in the same |
| structure. */ |
| struct netif *netif_find(char *name); |
| |
| void netif_set_default(struct netif *netif); |
| |
| void netif_set_ipaddr(struct netif *netif, ip_addr_t *ipaddr); |
| void netif_set_netmask(struct netif *netif, ip_addr_t *netmask); |
| void netif_set_gw(struct netif *netif, ip_addr_t *gw); |
| |
| void netif_set_up(struct netif *netif); |
| void netif_set_down(struct netif *netif); |
| /** Ask if an interface is up */ |
| #define netif_is_up(netif) (((netif)->flags & NETIF_FLAG_UP) ? (u8_t)1 : (u8_t)0) |
| |
| #if LWIP_NETIF_STATUS_CALLBACK |
| void netif_set_status_callback(struct netif *netif, netif_status_callback_fn status_callback); |
| #endif /* LWIP_NETIF_STATUS_CALLBACK */ |
| #if LWIP_NETIF_REMOVE_CALLBACK |
| void netif_set_remove_callback(struct netif *netif, netif_status_callback_fn remove_callback); |
| #endif /* LWIP_NETIF_REMOVE_CALLBACK */ |
| |
| void netif_set_link_up(struct netif *netif); |
| void netif_set_link_down(struct netif *netif); |
| /** Ask if a link is up */ |
| #define netif_is_link_up(netif) (((netif)->flags & NETIF_FLAG_LINK_UP) ? (u8_t)1 : (u8_t)0) |
| |
| #if LWIP_NETIF_LINK_CALLBACK |
| void netif_set_link_callback(struct netif *netif, netif_status_callback_fn link_callback); |
| #endif /* LWIP_NETIF_LINK_CALLBACK */ |
| |
| #if LWIP_NETIF_HOSTNAME |
| #define netif_set_hostname(netif, name) do { if((netif) != NULL) { (netif)->hostname = name; }}while(0) |
| #define netif_get_hostname(netif) (((netif) != NULL) ? ((netif)->hostname) : NULL) |
| #endif /* LWIP_NETIF_HOSTNAME */ |
| |
| #if LWIP_IGMP |
| #define netif_set_igmp_mac_filter(netif, function) do { if((netif) != NULL) { (netif)->igmp_mac_filter = function; }}while(0) |
| #define netif_get_igmp_mac_filter(netif) (((netif) != NULL) ? ((netif)->igmp_mac_filter) : NULL) |
| #endif /* LWIP_IGMP */ |
| |
| #if ENABLE_LOOPBACK |
| err_t netif_loop_output(struct netif *netif, struct pbuf *p, ip_addr_t *dest_ip); |
| void netif_poll(struct netif *netif); |
| #if !LWIP_NETIF_LOOPBACK_MULTITHREADING |
| void netif_poll_all(void); |
| #endif /* !LWIP_NETIF_LOOPBACK_MULTITHREADING */ |
| #endif /* ENABLE_LOOPBACK */ |
| |
| #if LWIP_IPV6 |
| #define netif_ip6_addr(netif, i) (&((netif)->ip6_addr[(i)])) |
| #define netif_ip6_addr_state(netif, i) ((netif)->ip6_addr_state[(i)]) |
| #define netif_ip6_addr_set_state(netif, i, state) ((netif)->ip6_addr_state[(i)] = (state)) |
| s8_t netif_matches_ip6_addr(struct netif * netif, ip6_addr_t * ip6addr); |
| void netif_create_ip6_linklocal_address(struct netif * netif, u8_t from_mac_48bit); |
| err_t netif_add_ip6_address(struct netif *netif, ip6_addr_t *ip6addr, s8_t *chosen_idx); |
| err_t netif_remove_ip6_address(struct netif *netif, ip6_addr_t *ip6addr); |
| err_t netif_add_ip6_address_with_route(struct netif *netif, ip6_addr_t *ip6addr, |
| u8_t prefix_len, s8_t *chosen_idx); |
| err_t netif_remove_ip6_address_with_route(struct netif *netif, ip6_addr_t *ip6addr, |
| u8_t prefix_len); |
| |
| #endif /* LWIP_IPV6 */ |
| |
| #if LWIP_NETIF_HWADDRHINT |
| #define NETIF_SET_HWADDRHINT(netif, hint) ((netif)->addr_hint = (hint)) |
| #else /* LWIP_NETIF_HWADDRHINT */ |
| #define NETIF_SET_HWADDRHINT(netif, hint) |
| #endif /* LWIP_NETIF_HWADDRHINT */ |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* __LWIP_NETIF_H__ */ |