Network interface (NETIF)

Modules
	IPv4 address handling
	IPv6 address handling
	Client data handling
	Flags
	MIB2 statistics

Macros
#define	netif_is_up(netif)   (((netif)->flags & NETIF_FLAG_UP) ? (u8_t)1 : (u8_t)0)
#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)
#define	netif_set_igmp_mac_filter(netif, function)   do { if((netif) != NULL) { (netif)->igmp_mac_filter = function; }}while(0)
#define	netif_set_mld_mac_filter(netif, function)   do { if((netif) != NULL) { (netif)->mld_mac_filter = function; }}while(0)

Functions
struct netif *	netif_add (struct netif *netif, const ip4_addr_t *ipaddr, const ip4_addr_t *netmask, const ip4_addr_t *gw, void *state, netif_init_fn init, netif_input_fn input)
void	netif_remove (struct netif *netif)
struct netif *	netif_find (const char *name)
void	netif_set_default (struct netif *netif)
void	netif_set_up (struct netif *netif)
void	netif_set_down (struct netif *netif)
void	netif_set_status_callback (struct netif *netif, netif_status_callback_fn status_callback)
void	netif_set_remove_callback (struct netif *netif, netif_status_callback_fn remove_callback)
void	netif_set_link_up (struct netif *netif)
void	netif_set_link_down (struct netif *netif)
void	netif_set_link_callback (struct netif *netif, netif_status_callback_fn link_callback)
err_t	netif_loop_output (struct netif *netif, struct pbuf *p)

Detailed Description

Macro Definition Documentation

netif_get_hostname

#define netif_get_hostname

(

netif

)

(((netif) != NULL) ? ((netif)->hostname) : NULL)

netif_is_up

#define netif_is_up

(

netif

)

(((netif)->flags & NETIF_FLAG_UP) ? (u8_t)1 : (u8_t)0)

Ask if an interface is up

netif_set_hostname

#define netif_set_hostname	(		netif,
			name
	)		do { if((netif) != NULL) { (netif)->hostname = name; }}while(0)

netif_set_igmp_mac_filter

#define netif_set_igmp_mac_filter	(		netif,
			function
	)		do { if((netif) != NULL) { (netif)->igmp_mac_filter = function; }}while(0)

netif_set_mld_mac_filter

#define netif_set_mld_mac_filter	(		netif,
			function
	)		do { if((netif) != NULL) { (netif)->mld_mac_filter = function; }}while(0)

Function Documentation

netif_add()

struct netif* netif_add	(	struct netif *	netif,
		const ip4_addr_t *	ipaddr,
		const ip4_addr_t *	netmask,
		const ip4_addr_t *	gw,
		void *	state,
		netif_init_fn	init,
		netif_input_fn	input
	)

Add a network interface to the list of lwIP netifs.

Parameters

netif	a pre-allocated netif structure
ipaddr	IP address for the new netif
netmask	network mask for the new netif
gw	default gateway IP address for the new netif
state	opaque data passed to the new netif
init	callback function that initializes the interface
input	callback function that is called to pass ingress packets up in the protocol layer stack. It is recommended to use a function that passes the input directly to the stack (netif_input(), NO_SYS=1 mode) or via sending a message to TCPIP thread (tcpip_input(), NO_SYS=0 mode). These functions use netif flags NETIF_FLAG_ETHARP and NETIF_FLAG_ETHERNET to decide whether to forward to ethernet_input() or ip_input(). In other words, the functions only work when the netif driver is implemented correctly! Most members of struct netif should be be initialized by the netif init function = netif driver (init parameter of this function). IPv6: Don't forget to call netif_create_ip6_linklocal_address() after setting the MAC address in struct netif.hwaddr (IPv6 requires a link-local address).

Returns

netif, or NULL if failed.

netif_find()

struct netif* netif_find

(

const char *

name

)

Find a network interface by searching for its name

Parameters

name	the name of the netif (like netif->name) plus concatenated number in ascii representation (e.g. 'en0')

netif_loop_output()

err_t netif_loop_output	(	struct netif *	netif,
		struct pbuf *	p
	)

Send an IP packet to be received on the same netif (loopif-like). The pbuf is simply copied and handed back to netif->input. In multithreaded mode, this is done directly since netif->input must put the packet on a queue. In callback mode, the packet is put on an internal queue and is fed to netif->input by netif_poll().

Parameters

netif	the lwip network interface structure
p	the (IP) packet to 'send'

Returns

ERR_OK if the packet has been sent ERR_MEM if the pbuf used to copy the packet couldn't be allocated

netif_remove()

void netif_remove

(

struct netif *

netif

)

Remove a network interface from the list of lwIP netifs.

Parameters

netif

the network interface to remove

netif_set_default()

void netif_set_default

(

struct netif *

netif

)

Set a network interface as the default network interface (used to output all packets for which no specific route is found)

Parameters

netif

the default network interface

netif_set_down()

void netif_set_down

(

struct netif *

netif

)

Bring an interface down, disabling any traffic processing.

netif_set_link_callback()

void netif_set_link_callback	(	struct netif *	netif,
		netif_status_callback_fn	link_callback
	)

Set callback to be called when link is brought up/down

netif_set_link_down()

void netif_set_link_down

(

struct netif *

netif

)

Called by a driver when its link goes down

netif_set_link_up()

void netif_set_link_up

(

struct netif *

netif

)

Called by a driver when its link goes up

netif_set_remove_callback()

void netif_set_remove_callback	(	struct netif *	netif,
		netif_status_callback_fn	remove_callback
	)

Set callback to be called when the interface has been removed

netif_set_status_callback()

void netif_set_status_callback	(	struct netif *	netif,
		netif_status_callback_fn	status_callback
	)

Set callback to be called when interface is brought up/down or address is changed while up

netif_set_up()

void netif_set_up

(

struct netif *

netif

)

Bring an interface up, available for processing traffic.