Zephyr API Documentation  2.7.0-rc2
A Scalable Open Source RTOS
Network Interface abstraction layer

Network Interface abstraction layer. More...

Data Structures

struct  net_if_addr
 Network Interface unicast IP addresses. More...
 
struct  net_if_mcast_addr
 Network Interface multicast IP addresses. More...
 
struct  net_if_ipv6_prefix
 Network Interface IPv6 prefixes. More...
 
struct  net_if_router
 Information about routers in the system. More...
 
struct  net_if_ipv6
 
struct  net_if_ipv4
 
struct  net_if_ip
 Network interface IP address configuration. More...
 
struct  net_if_config
 IP and other configuration related data for network interface. More...
 
struct  net_traffic_class
 Network traffic class. More...
 
struct  net_if_dev
 Network Interface Device structure. More...
 
struct  net_if
 Network Interface structure. More...
 
struct  net_if_mcast_monitor
 Multicast monitor handler struct. More...
 
struct  net_if_link_cb
 Link callback handler struct. More...
 

Macros

#define NET_DEVICE_INIT(dev_name, drv_name, init_fn, pm_control_fn, data, cfg, prio, api, l2, l2_ctx_type, mtu)
 Create a network interface and bind it to network device. More...
 
#define NET_DEVICE_DT_DEFINE(node_id, init_fn, pm_control_fn, data, cfg, prio, api, l2, l2_ctx_type, mtu)
 Like NET_DEVICE_INIT but taking metadata from a devicetree node. Create a network interface and bind it to network device. More...
 
#define NET_DEVICE_DT_INST_DEFINE(inst, ...)    NET_DEVICE_DT_DEFINE(DT_DRV_INST(inst), __VA_ARGS__)
 Like NET_DEVICE_DT_DEFINE for an instance of a DT_DRV_COMPAT compatible. More...
 
#define NET_DEVICE_INIT_INSTANCE(dev_name, drv_name, instance, init_fn, pm_control_fn, data, cfg, prio, api, l2, l2_ctx_type, mtu)
 Create multiple network interfaces and bind them to network device. If your network device needs more than one instance of a network interface, use this macro below and provide a different instance suffix each time (0, 1, 2, ... or a, b, c ... whatever works for you) More...
 
#define NET_DEVICE_DT_DEFINE_INSTANCE(node_id, instance, init_fn, pm_control_fn, data, cfg, prio, api, l2, l2_ctx_type, mtu)
 Like NET_DEVICE_OFFLOAD_INIT but taking metadata from a devicetree. Create multiple network interfaces and bind them to network device. If your network device needs more than one instance of a network interface, use this macro below and provide a different instance suffix each time (0, 1, 2, ... or a, b, c ... whatever works for you) More...
 
#define NET_DEVICE_DT_INST_DEFINE_INSTANCE(inst, ...)    NET_DEVICE_DT_DEFINE_INSTANCE(DT_DRV_INST(inst), __VA_ARGS__)
 Like NET_DEVICE_DT_DEFINE_INSTANCE for an instance of a DT_DRV_COMPAT compatible. More...
 
#define NET_DEVICE_OFFLOAD_INIT(dev_name, drv_name, init_fn, pm_control_fn, data, cfg, prio, api, mtu)
 Create a offloaded network interface and bind it to network device. The offloaded network interface is implemented by a device vendor HAL or similar. More...
 
#define NET_DEVICE_DT_OFFLOAD_DEFINE(node_id, init_fn, pm_control_fn, data, cfg, prio, api, mtu)
 Like NET_DEVICE_OFFLOAD_INIT but taking metadata from a devicetree node. Create a offloaded network interface and bind it to network device. The offloaded network interface is implemented by a device vendor HAL or similar. More...
 
#define NET_DEVICE_DT_INST_OFFLOAD_DEFINE(inst, ...)    NET_DEVICE_DT_OFFLOAD_DEFINE(DT_DRV_INST(inst), __VA_ARGS__)
 Like NET_DEVICE_DT_OFFLOAD_DEFINE for an instance of a DT_DRV_COMPAT compatible. More...
 

Typedefs

typedef void(* net_if_mcast_callback_t) (struct net_if *iface, const struct in6_addr *addr, bool is_joined)
 Define callback that is called whenever IPv6 multicast address group is joined or left. More...
 
typedef void(* net_if_link_callback_t) (struct net_if *iface, struct net_linkaddr *dst, int status)
 Define callback that is called after a network packet has been sent. More...
 
typedef void(* net_if_cb_t) (struct net_if *iface, void *user_data)
 Callback used while iterating over network interfaces. More...
 

Enumerations

enum  net_if_flag {
  NET_IF_UP , NET_IF_POINTOPOINT , NET_IF_PROMISC , NET_IF_NO_AUTO_START ,
  NET_IF_SUSPENDED , NET_IF_FORWARD_MULTICASTS , NET_IF_IPV4 , NET_IF_IPV6
}
 

Functions

static void net_if_flag_set (struct net_if *iface, enum net_if_flag value)
 Set a value in network interface flags. More...
 
static bool net_if_flag_test_and_set (struct net_if *iface, enum net_if_flag value)
 Test and set a value in network interface flags. More...
 
static void net_if_flag_clear (struct net_if *iface, enum net_if_flag value)
 Clear a value in network interface flags. More...
 
static bool net_if_flag_is_set (struct net_if *iface, enum net_if_flag value)
 Check if a value in network interface flags is set. More...
 
enum net_verdict net_if_send_data (struct net_if *iface, struct net_pkt *pkt)
 Send a packet through a net iface. More...
 
static const struct net_l2 *const net_if_l2 (struct net_if *iface)
 Get a pointer to the interface L2. More...
 
enum net_verdict net_if_recv_data (struct net_if *iface, struct net_pkt *pkt)
 Input a packet through a net iface. More...
 
static voidnet_if_l2_data (struct net_if *iface)
 Get a pointer to the interface L2 private data. More...
 
static const struct devicenet_if_get_device (struct net_if *iface)
 Get an network interface's device. More...
 
void net_if_queue_tx (struct net_if *iface, struct net_pkt *pkt)
 Queue a packet to the net interface TX queue. More...
 
static bool net_if_is_ip_offloaded (struct net_if *iface)
 Return the IP offload status. More...
 
static struct net_offload * net_if_offload (struct net_if *iface)
 Return the IP offload plugin. More...
 
static bool net_if_is_socket_offloaded (struct net_if *iface)
 Return the socket offload status. More...
 
static struct net_linkaddrnet_if_get_link_addr (struct net_if *iface)
 Get an network interface's link address. More...
 
static struct net_if_confignet_if_get_config (struct net_if *iface)
 Return network configuration for this network interface. More...
 
static void net_if_start_dad (struct net_if *iface)
 Start duplicate address detection procedure. More...
 
void net_if_start_rs (struct net_if *iface)
 Start neighbor discovery and send router solicitation message. More...
 
static void net_if_stop_rs (struct net_if *iface)
 Stop neighbor discovery. More...
 
static int net_if_set_link_addr (struct net_if *iface, uint8_t *addr, uint8_t len, enum net_link_type type)
 Set a network interface's link address. More...
 
static uint16_t net_if_get_mtu (struct net_if *iface)
 Get an network interface's MTU. More...
 
static void net_if_set_mtu (struct net_if *iface, uint16_t mtu)
 Set an network interface's MTU. More...
 
static void net_if_addr_set_lf (struct net_if_addr *ifaddr, bool is_infinite)
 Set the infinite status of the network interface address. More...
 
struct net_ifnet_if_get_by_link_addr (struct net_linkaddr *ll_addr)
 Get an interface according to link layer address. More...
 
struct net_ifnet_if_lookup_by_dev (const struct device *dev)
 Find an interface from it's related device. More...
 
static struct net_if_confignet_if_config_get (struct net_if *iface)
 Get network interface IP config. More...
 
void net_if_router_rm (struct net_if_router *router)
 Remove a router from the system. More...
 
struct net_ifnet_if_get_default (void)
 Get the default network interface. More...
 
struct net_ifnet_if_get_first_by_type (const struct net_l2 *l2)
 Get the first network interface according to its type. More...
 
int net_if_config_ipv6_get (struct net_if *iface, struct net_if_ipv6 **ipv6)
 Allocate network interface IPv6 config. More...
 
int net_if_config_ipv6_put (struct net_if *iface)
 Release network interface IPv6 config. More...
 
struct net_if_addrnet_if_ipv6_addr_lookup (const struct in6_addr *addr, struct net_if **iface)
 Check if this IPv6 address belongs to one of the interfaces. More...
 
struct net_if_addrnet_if_ipv6_addr_lookup_by_iface (struct net_if *iface, struct in6_addr *addr)
 Check if this IPv6 address belongs to this specific interfaces. More...
 
int net_if_ipv6_addr_lookup_by_index (const struct in6_addr *addr)
 Check if this IPv6 address belongs to one of the interface indices. More...
 
struct net_if_addrnet_if_ipv6_addr_add (struct net_if *iface, struct in6_addr *addr, enum net_addr_type addr_type, uint32_t vlifetime)
 Add a IPv6 address to an interface. More...
 
bool net_if_ipv6_addr_add_by_index (int index, struct in6_addr *addr, enum net_addr_type addr_type, uint32_t vlifetime)
 Add a IPv6 address to an interface by index. More...
 
void net_if_ipv6_addr_update_lifetime (struct net_if_addr *ifaddr, uint32_t vlifetime)
 Update validity lifetime time of an IPv6 address. More...
 
bool net_if_ipv6_addr_rm (struct net_if *iface, const struct in6_addr *addr)
 Remove an IPv6 address from an interface. More...
 
bool net_if_ipv6_addr_rm_by_index (int index, const struct in6_addr *addr)
 Remove an IPv6 address from an interface by index. More...
 
struct net_if_mcast_addrnet_if_ipv6_maddr_add (struct net_if *iface, const struct in6_addr *addr)
 Add a IPv6 multicast address to an interface. More...
 
bool net_if_ipv6_maddr_rm (struct net_if *iface, const struct in6_addr *addr)
 Remove an IPv6 multicast address from an interface. More...
 
struct net_if_mcast_addrnet_if_ipv6_maddr_lookup (const struct in6_addr *addr, struct net_if **iface)
 Check if this IPv6 multicast address belongs to a specific interface or one of the interfaces. More...
 
void net_if_mcast_mon_register (struct net_if_mcast_monitor *mon, struct net_if *iface, net_if_mcast_callback_t cb)
 Register a multicast monitor. More...
 
void net_if_mcast_mon_unregister (struct net_if_mcast_monitor *mon)
 Unregister a multicast monitor. More...
 
void net_if_mcast_monitor (struct net_if *iface, const struct in6_addr *addr, bool is_joined)
 Call registered multicast monitors. More...
 
void net_if_ipv6_maddr_join (struct net_if_mcast_addr *addr)
 Mark a given multicast address to be joined. More...
 
static bool net_if_ipv6_maddr_is_joined (struct net_if_mcast_addr *addr)
 Check if given multicast address is joined or not. More...
 
void net_if_ipv6_maddr_leave (struct net_if_mcast_addr *addr)
 Mark a given multicast address to be left. More...
 
struct net_if_ipv6_prefixnet_if_ipv6_prefix_get (struct net_if *iface, struct in6_addr *addr)
 Return prefix that corresponds to this IPv6 address. More...
 
struct net_if_ipv6_prefixnet_if_ipv6_prefix_lookup (struct net_if *iface, struct in6_addr *addr, uint8_t len)
 Check if this IPv6 prefix belongs to this interface. More...
 
struct net_if_ipv6_prefixnet_if_ipv6_prefix_add (struct net_if *iface, struct in6_addr *prefix, uint8_t len, uint32_t lifetime)
 Add a IPv6 prefix to an network interface. More...
 
bool net_if_ipv6_prefix_rm (struct net_if *iface, struct in6_addr *addr, uint8_t len)
 Remove an IPv6 prefix from an interface. More...
 
static void net_if_ipv6_prefix_set_lf (struct net_if_ipv6_prefix *prefix, bool is_infinite)
 Set the infinite status of the prefix. More...
 
void net_if_ipv6_prefix_set_timer (struct net_if_ipv6_prefix *prefix, uint32_t lifetime)
 Set the prefix lifetime timer. More...
 
void net_if_ipv6_prefix_unset_timer (struct net_if_ipv6_prefix *prefix)
 Unset the prefix lifetime timer. More...
 
bool net_if_ipv6_addr_onlink (struct net_if **iface, struct in6_addr *addr)
 Check if this IPv6 address is part of the subnet of our network interface. More...
 
static struct in6_addrnet_if_router_ipv6 (struct net_if_router *router)
 Get the IPv6 address of the given router. More...
 
struct net_if_routernet_if_ipv6_router_lookup (struct net_if *iface, struct in6_addr *addr)
 Check if IPv6 address is one of the routers configured in the system. More...
 
struct net_if_routernet_if_ipv6_router_find_default (struct net_if *iface, struct in6_addr *addr)
 Find default router for this IPv6 address. More...
 
void net_if_ipv6_router_update_lifetime (struct net_if_router *router, uint16_t lifetime)
 Update validity lifetime time of a router. More...
 
struct net_if_routernet_if_ipv6_router_add (struct net_if *iface, struct in6_addr *addr, uint16_t router_lifetime)
 Add IPv6 router to the system. More...
 
bool net_if_ipv6_router_rm (struct net_if_router *router)
 Remove IPv6 router from the system. More...
 
uint8_t net_if_ipv6_get_hop_limit (struct net_if *iface)
 Get IPv6 hop limit specified for a given interface. This is the default value but can be overridden by the user. More...
 
void net_ipv6_set_hop_limit (struct net_if *iface, uint8_t hop_limit)
 Set the default IPv6 hop limit of a given interface. More...
 
static void net_if_ipv6_set_base_reachable_time (struct net_if *iface, uint32_t reachable_time)
 Set IPv6 reachable time for a given interface. More...
 
static uint32_t net_if_ipv6_get_reachable_time (struct net_if *iface)
 Get IPv6 reachable timeout specified for a given interface. More...
 
uint32_t net_if_ipv6_calc_reachable_time (struct net_if_ipv6 *ipv6)
 Calculate next reachable time value for IPv6 reachable time. More...
 
static void net_if_ipv6_set_reachable_time (struct net_if_ipv6 *ipv6)
 Set IPv6 reachable time for a given interface. This requires that base reachable time is set for the interface. More...
 
static void net_if_ipv6_set_retrans_timer (struct net_if *iface, uint32_t retrans_timer)
 Set IPv6 retransmit timer for a given interface. More...
 
static uint32_t net_if_ipv6_get_retrans_timer (struct net_if *iface)
 Get IPv6 retransmit timer specified for a given interface. More...
 
static const struct in6_addrnet_if_ipv6_select_src_addr (struct net_if *iface, const struct in6_addr *dst)
 Get a IPv6 source address that should be used when sending network data to destination. More...
 
static struct net_ifnet_if_ipv6_select_src_iface (const struct in6_addr *dst)
 Get a network interface that should be used when sending IPv6 network data to destination. More...
 
struct in6_addrnet_if_ipv6_get_ll (struct net_if *iface, enum net_addr_state addr_state)
 Get a IPv6 link local address in a given state. More...
 
struct in6_addrnet_if_ipv6_get_ll_addr (enum net_addr_state state, struct net_if **iface)
 Return link local IPv6 address from the first interface that has a link local address matching give state. More...
 
void net_if_ipv6_dad_failed (struct net_if *iface, const struct in6_addr *addr)
 Stop IPv6 Duplicate Address Detection (DAD) procedure if we find out that our IPv6 address is already in use. More...
 
struct in6_addrnet_if_ipv6_get_global_addr (enum net_addr_state state, struct net_if **iface)
 Return global IPv6 address from the first interface that has a global IPv6 address matching the given state. More...
 
int net_if_config_ipv4_get (struct net_if *iface, struct net_if_ipv4 **ipv4)
 Allocate network interface IPv4 config. More...
 
int net_if_config_ipv4_put (struct net_if *iface)
 Release network interface IPv4 config. More...
 
uint8_t net_if_ipv4_get_ttl (struct net_if *iface)
 Get IPv4 time-to-live value specified for a given interface. More...
 
void net_if_ipv4_set_ttl (struct net_if *iface, uint8_t ttl)
 Set IPv4 time-to-live value specified to a given interface. More...
 
struct net_if_addrnet_if_ipv4_addr_lookup (const struct in_addr *addr, struct net_if **iface)
 Check if this IPv4 address belongs to one of the interfaces. More...
 
struct net_if_addrnet_if_ipv4_addr_add (struct net_if *iface, struct in_addr *addr, enum net_addr_type addr_type, uint32_t vlifetime)
 Add a IPv4 address to an interface. More...
 
bool net_if_ipv4_addr_rm (struct net_if *iface, const struct in_addr *addr)
 Remove a IPv4 address from an interface. More...
 
int net_if_ipv4_addr_lookup_by_index (const struct in_addr *addr)
 Check if this IPv4 address belongs to one of the interface indices. More...
 
bool net_if_ipv4_addr_add_by_index (int index, struct in_addr *addr, enum net_addr_type addr_type, uint32_t vlifetime)
 Add a IPv4 address to an interface by network interface index. More...
 
bool net_if_ipv4_addr_rm_by_index (int index, const struct in_addr *addr)
 Remove a IPv4 address from an interface by interface index. More...
 
struct net_if_mcast_addrnet_if_ipv4_maddr_add (struct net_if *iface, const struct in_addr *addr)
 Add a IPv4 multicast address to an interface. More...
 
bool net_if_ipv4_maddr_rm (struct net_if *iface, const struct in_addr *addr)
 Remove an IPv4 multicast address from an interface. More...
 
struct net_if_mcast_addrnet_if_ipv4_maddr_lookup (const struct in_addr *addr, struct net_if **iface)
 Check if this IPv4 multicast address belongs to a specific interface or one of the interfaces. More...
 
void net_if_ipv4_maddr_join (struct net_if_mcast_addr *addr)
 Mark a given multicast address to be joined. More...
 
static bool net_if_ipv4_maddr_is_joined (struct net_if_mcast_addr *addr)
 Check if given multicast address is joined or not. More...
 
void net_if_ipv4_maddr_leave (struct net_if_mcast_addr *addr)
 Mark a given multicast address to be left. More...
 
static struct in_addrnet_if_router_ipv4 (struct net_if_router *router)
 Get the IPv4 address of the given router. More...
 
struct net_if_routernet_if_ipv4_router_lookup (struct net_if *iface, struct in_addr *addr)
 Check if IPv4 address is one of the routers configured in the system. More...
 
struct net_if_routernet_if_ipv4_router_find_default (struct net_if *iface, struct in_addr *addr)
 Find default router for this IPv4 address. More...
 
struct net_if_routernet_if_ipv4_router_add (struct net_if *iface, struct in_addr *addr, bool is_default, uint16_t router_lifetime)
 Add IPv4 router to the system. More...
 
bool net_if_ipv4_router_rm (struct net_if_router *router)
 Remove IPv4 router from the system. More...
 
bool net_if_ipv4_addr_mask_cmp (struct net_if *iface, const struct in_addr *addr)
 Check if the given IPv4 address belongs to local subnet. More...
 
bool net_if_ipv4_is_addr_bcast (struct net_if *iface, const struct in_addr *addr)
 Check if the given IPv4 address is a broadcast address. More...
 
static struct net_ifnet_if_ipv4_select_src_iface (const struct in_addr *dst)
 Get a network interface that should be used when sending IPv4 network data to destination. More...
 
static const struct in_addrnet_if_ipv4_select_src_addr (struct net_if *iface, const struct in_addr *dst)
 Get a IPv4 source address that should be used when sending network data to destination. More...
 
struct in_addrnet_if_ipv4_get_ll (struct net_if *iface, enum net_addr_state addr_state)
 Get a IPv4 link local address in a given state. More...
 
struct in_addrnet_if_ipv4_get_global_addr (struct net_if *iface, enum net_addr_state addr_state)
 Get a IPv4 global address in a given state. More...
 
void net_if_ipv4_set_netmask (struct net_if *iface, const struct in_addr *netmask)
 Set IPv4 netmask for an interface. More...
 
bool net_if_ipv4_set_netmask_by_index (int index, const struct in_addr *netmask)
 Set IPv4 netmask for an interface index. More...
 
void net_if_ipv4_set_gw (struct net_if *iface, const struct in_addr *gw)
 Set IPv4 gateway for an interface. More...
 
bool net_if_ipv4_set_gw_by_index (int index, const struct in_addr *gw)
 Set IPv4 gateway for an interface index. More...
 
struct net_ifnet_if_select_src_iface (const struct sockaddr *dst)
 Get a network interface that should be used when sending IPv6 or IPv4 network data to destination. More...
 
void net_if_register_link_cb (struct net_if_link_cb *link, net_if_link_callback_t cb)
 Register a link callback. More...
 
void net_if_unregister_link_cb (struct net_if_link_cb *link)
 Unregister a link callback. More...
 
void net_if_call_link_cb (struct net_if *iface, struct net_linkaddr *lladdr, int status)
 Call a link callback function. More...
 
bool net_if_need_calc_rx_checksum (struct net_if *iface)
 Check if received network packet checksum calculation can be avoided or not. For example many ethernet devices support network packet offloading in which case the IP stack does not need to calculate the checksum. More...
 
bool net_if_need_calc_tx_checksum (struct net_if *iface)
 Check if network packet checksum calculation can be avoided or not when sending the packet. For example many ethernet devices support network packet offloading in which case the IP stack does not need to calculate the checksum. More...
 
struct net_ifnet_if_get_by_index (int index)
 Get interface according to index. More...
 
int net_if_get_by_iface (struct net_if *iface)
 Get interface index according to pointer. More...
 
void net_if_foreach (net_if_cb_t cb, void *user_data)
 Go through all the network interfaces and call callback for each interface. More...
 
int net_if_up (struct net_if *iface)
 Bring interface up. More...
 
static bool net_if_is_up (struct net_if *iface)
 Check if interface is up. More...
 
int net_if_down (struct net_if *iface)
 Bring interface down. More...
 
int net_if_set_promisc (struct net_if *iface)
 Set network interface into promiscuous mode. More...
 
void net_if_unset_promisc (struct net_if *iface)
 Set network interface into normal mode. More...
 
bool net_if_is_promisc (struct net_if *iface)
 Check if promiscuous mode is set or not. More...
 
static bool net_if_are_pending_tx_packets (struct net_if *iface)
 Check if there are any pending TX network data for a given network interface. More...
 

Detailed Description

Network Interface abstraction layer.

Macro Definition Documentation

◆ NET_DEVICE_DT_DEFINE

#define NET_DEVICE_DT_DEFINE (   node_id,
  init_fn,
  pm_control_fn,
  data,
  cfg,
  prio,
  api,
  l2,
  l2_ctx_type,
  mtu 
)

#include <include/net/net_if.h>

Value:
Z_NET_DEVICE_INIT(node_id, Z_DEVICE_DT_DEV_NAME(node_id), \
DT_PROP_OR(node_id, label, ""), init_fn, \
pm_control_fn, data, cfg, prio, api, l2, \
l2_ctx_type, mtu)
#define DT_PROP_OR(node_id, prop, default_value)
Like DT_PROP(), but with a fallback to default_value.
Definition: devicetree.h:640
static fdata_t data[2]
Definition: test_fifo_contexts.c:15

Like NET_DEVICE_INIT but taking metadata from a devicetree node. Create a network interface and bind it to network device.

Parameters
node_idThe devicetree node identifier.
init_fnAddress to the init function of the driver.
pm_control_fnPointer to pm_control function. Can be NULL if not implemented.
dataPointer to the device's private data.
cfgThe address to the structure containing the configuration information for this instance of the driver.
prioThe initialization level at which configuration occurs.
apiProvides an initial pointer to the API function struct used by the driver. Can be NULL.
l2Network L2 layer for this network interface.
l2_ctx_typeType of L2 context data.
mtuMaximum transfer unit in bytes for this network interface.

◆ NET_DEVICE_DT_DEFINE_INSTANCE

#define NET_DEVICE_DT_DEFINE_INSTANCE (   node_id,
  instance,
  init_fn,
  pm_control_fn,
  data,
  cfg,
  prio,
  api,
  l2,
  l2_ctx_type,
  mtu 
)

#include <include/net/net_if.h>

Value:
Z_NET_DEVICE_INIT_INSTANCE(node_id, node_id, DT_LABEL(node_id), \
instance, init_fn, pm_control_fn, \
data, cfg, prio, api, l2, \
l2_ctx_type, mtu)
#define DT_LABEL(node_id)
Equivalent to DT_PROP(node_id, label)
Definition: devicetree.h:652

Like NET_DEVICE_OFFLOAD_INIT but taking metadata from a devicetree. Create multiple network interfaces and bind them to network device. If your network device needs more than one instance of a network interface, use this macro below and provide a different instance suffix each time (0, 1, 2, ... or a, b, c ... whatever works for you)

Parameters
node_idThe devicetree node identifier.
instanceInstance identifier.
init_fnAddress to the init function of the driver.
pm_control_fnPointer to pm_control function. Can be NULL if not implemented.
dataPointer to the device's private data.
cfgThe address to the structure containing the configuration information for this instance of the driver.
prioThe initialization level at which configuration occurs.
apiProvides an initial pointer to the API function struct used by the driver. Can be NULL.
l2Network L2 layer for this network interface.
l2_ctx_typeType of L2 context data.
mtuMaximum transfer unit in bytes for this network interface.

◆ NET_DEVICE_DT_INST_DEFINE

#define NET_DEVICE_DT_INST_DEFINE (   inst,
  ... 
)     NET_DEVICE_DT_DEFINE(DT_DRV_INST(inst), __VA_ARGS__)

#include <include/net/net_if.h>

Like NET_DEVICE_DT_DEFINE for an instance of a DT_DRV_COMPAT compatible.

Parameters
instinstance number. This is replaced by DT_DRV_COMPAT(inst) in the call to NET_DEVICE_DT_DEFINE.
...other parameters as expected by NET_DEVICE_DT_DEFINE.

◆ NET_DEVICE_DT_INST_DEFINE_INSTANCE

#define NET_DEVICE_DT_INST_DEFINE_INSTANCE (   inst,
  ... 
)     NET_DEVICE_DT_DEFINE_INSTANCE(DT_DRV_INST(inst), __VA_ARGS__)

#include <include/net/net_if.h>

Like NET_DEVICE_DT_DEFINE_INSTANCE for an instance of a DT_DRV_COMPAT compatible.

Parameters
instinstance number. This is replaced by DT_DRV_COMPAT(inst) in the call to NET_DEVICE_DT_DEFINE_INSTANCE.
...other parameters as expected by NET_DEVICE_DT_DEFINE_INSTANCE.

◆ NET_DEVICE_DT_INST_OFFLOAD_DEFINE

#define NET_DEVICE_DT_INST_OFFLOAD_DEFINE (   inst,
  ... 
)     NET_DEVICE_DT_OFFLOAD_DEFINE(DT_DRV_INST(inst), __VA_ARGS__)

#include <include/net/net_if.h>

Like NET_DEVICE_DT_OFFLOAD_DEFINE for an instance of a DT_DRV_COMPAT compatible.

Parameters
instinstance number. This is replaced by DT_DRV_COMPAT(inst) in the call to NET_DEVICE_DT_OFFLOAD_DEFINE.
...other parameters as expected by NET_DEVICE_DT_OFFLOAD_DEFINE.

◆ NET_DEVICE_DT_OFFLOAD_DEFINE

#define NET_DEVICE_DT_OFFLOAD_DEFINE (   node_id,
  init_fn,
  pm_control_fn,
  data,
  cfg,
  prio,
  api,
  mtu 
)

#include <include/net/net_if.h>

Value:
Z_NET_DEVICE_OFFLOAD_INIT(node_id, Z_DEVICE_DT_DEV_NAME(node_id), \
DT_PROP_OR(node_id, label, NULL), \
init_fn, pm_control_fn, data, cfg, \
prio, api, mtu)

Like NET_DEVICE_OFFLOAD_INIT but taking metadata from a devicetree node. Create a offloaded network interface and bind it to network device. The offloaded network interface is implemented by a device vendor HAL or similar.

Parameters
node_idThe devicetree node identifier.
init_fnAddress to the init function of the driver.
pm_control_fnPointer to pm_control function. Can be NULL if not implemented.
dataPointer to the device's private data.
cfgThe address to the structure containing the configuration information for this instance of the driver.
prioThe initialization level at which configuration occurs.
apiProvides an initial pointer to the API function struct used by the driver. Can be NULL.
mtuMaximum transfer unit in bytes for this network interface.

◆ NET_DEVICE_INIT

#define NET_DEVICE_INIT (   dev_name,
  drv_name,
  init_fn,
  pm_control_fn,
  data,
  cfg,
  prio,
  api,
  l2,
  l2_ctx_type,
  mtu 
)

#include <include/net/net_if.h>

Value:
Z_NET_DEVICE_INIT(DT_INVALID_NODE, dev_name, drv_name, init_fn, \
pm_control_fn, data, cfg, prio, api, l2, \
l2_ctx_type, mtu)
#define DT_INVALID_NODE
Name for an invalid node identifier.
Definition: devicetree.h:76

Create a network interface and bind it to network device.

Parameters
dev_nameNetwork device name.
drv_nameThe name this instance of the driver exposes to the system.
init_fnAddress to the init function of the driver.
pm_control_fnPointer to pm_control function. Can be NULL if not implemented.
dataPointer to the device's private data.
cfgThe address to the structure containing the configuration information for this instance of the driver.
prioThe initialization level at which configuration occurs.
apiProvides an initial pointer to the API function struct used by the driver. Can be NULL.
l2Network L2 layer for this network interface.
l2_ctx_typeType of L2 context data.
mtuMaximum transfer unit in bytes for this network interface.

◆ NET_DEVICE_INIT_INSTANCE

#define NET_DEVICE_INIT_INSTANCE (   dev_name,
  drv_name,
  instance,
  init_fn,
  pm_control_fn,
  data,
  cfg,
  prio,
  api,
  l2,
  l2_ctx_type,
  mtu 
)

#include <include/net/net_if.h>

Value:
Z_NET_DEVICE_INIT_INSTANCE(DT_INVALID_NODE, dev_name, drv_name, \
instance, init_fn, pm_control_fn, \
data, cfg, prio, api, l2, \
l2_ctx_type, mtu)

Create multiple network interfaces and bind them to network device. If your network device needs more than one instance of a network interface, use this macro below and provide a different instance suffix each time (0, 1, 2, ... or a, b, c ... whatever works for you)

Parameters
dev_nameNetwork device name.
drv_nameThe name this instance of the driver exposes to the system.
instanceInstance identifier.
init_fnAddress to the init function of the driver.
pm_control_fnPointer to pm_control function. Can be NULL if not implemented.
dataPointer to the device's private data.
cfgThe address to the structure containing the configuration information for this instance of the driver.
prioThe initialization level at which configuration occurs.
apiProvides an initial pointer to the API function struct used by the driver. Can be NULL.
l2Network L2 layer for this network interface.
l2_ctx_typeType of L2 context data.
mtuMaximum transfer unit in bytes for this network interface.

◆ NET_DEVICE_OFFLOAD_INIT

#define NET_DEVICE_OFFLOAD_INIT (   dev_name,
  drv_name,
  init_fn,
  pm_control_fn,
  data,
  cfg,
  prio,
  api,
  mtu 
)

#include <include/net/net_if.h>

Value:
Z_NET_DEVICE_OFFLOAD_INIT(DT_INVALID_NODE, dev_name, drv_name, \
init_fn, pm_control_fn, data, cfg, prio,\
api, mtu)

Create a offloaded network interface and bind it to network device. The offloaded network interface is implemented by a device vendor HAL or similar.

Parameters
dev_nameNetwork device name.
drv_nameThe name this instance of the driver exposes to the system.
init_fnAddress to the init function of the driver.
pm_control_fnPointer to pm_control function. Can be NULL if not implemented.
dataPointer to the device's private data.
cfgThe address to the structure containing the configuration information for this instance of the driver.
prioThe initialization level at which configuration occurs.
apiProvides an initial pointer to the API function struct used by the driver. Can be NULL.
mtuMaximum transfer unit in bytes for this network interface.

Typedef Documentation

◆ net_if_cb_t

net_if_cb_t

#include <include/net/net_if.h>

Callback used while iterating over network interfaces.

Parameters
ifacePointer to current network interface
user_dataA valid pointer to user data or NULL

◆ net_if_link_callback_t

net_if_link_callback_t

#include <include/net/net_if.h>

Define callback that is called after a network packet has been sent.

Parameters
ifaceA pointer to a struct net_if to which the the net_pkt was sent to.
dstLink layer address of the destination where the network packet was sent.
statusSend status, 0 is ok, < 0 error.

◆ net_if_mcast_callback_t

net_if_mcast_callback_t

#include <include/net/net_if.h>

Define callback that is called whenever IPv6 multicast address group is joined or left.

Parameters
ifaceA pointer to a struct net_if to which the multicast address is attached.
addrIPv6 multicast address.
is_joinedTrue if the address is joined, false if left.

Enumeration Type Documentation

◆ net_if_flag

#include <include/net/net_if.h>

Enumerator
NET_IF_UP 

Interface is up/ready to receive and transmit

NET_IF_POINTOPOINT 

Interface is pointopoint

NET_IF_PROMISC 

Interface is in promiscuous mode

NET_IF_NO_AUTO_START 

Do not start the interface immediately after initialization. This requires that either the device driver or some other entity will need to manually take the interface up when needed. For example for Ethernet this will happen when the driver calls the net_eth_carrier_on() function.

NET_IF_SUSPENDED 

Power management specific: interface is being suspended

NET_IF_FORWARD_MULTICASTS 

Flag defines if received multicasts of other interface are forwarded on this interface. This activates multicast routing / forwarding for this interface.

NET_IF_IPV4 

Interface supports IPv4

NET_IF_IPV6 

Interface supports IPv6

Function Documentation

◆ net_if_addr_set_lf()

static void net_if_addr_set_lf ( struct net_if_addr ifaddr,
bool  is_infinite 
)
inlinestatic

#include <include/net/net_if.h>

Set the infinite status of the network interface address.

Parameters
ifaddrIP address for network interface
is_infiniteInfinite status

◆ net_if_are_pending_tx_packets()

static bool net_if_are_pending_tx_packets ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Check if there are any pending TX network data for a given network interface.

Parameters
ifacePointer to network interface
Returns
True if there are pending TX network packets for this network interface, False otherwise.

◆ net_if_call_link_cb()

void net_if_call_link_cb ( struct net_if iface,
struct net_linkaddr lladdr,
int  status 
)

#include <include/net/net_if.h>

Call a link callback function.

Parameters
ifaceNetwork interface.
lladdrDestination link layer address
status0 is ok, < 0 error

◆ net_if_config_get()

static struct net_if_config * net_if_config_get ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Get network interface IP config.

Parameters
ifaceInterface to use.
Returns
NULL if not found or pointer to correct config settings.

◆ net_if_config_ipv4_get()

int net_if_config_ipv4_get ( struct net_if iface,
struct net_if_ipv4 **  ipv4 
)

#include <include/net/net_if.h>

Allocate network interface IPv4 config.

This function will allocate new IPv4 config.

Parameters
ifaceInterface to use.
ipv4Pointer to allocated IPv4 struct is returned to caller.
Returns
0 if ok, <0 if error

◆ net_if_config_ipv4_put()

int net_if_config_ipv4_put ( struct net_if iface)

#include <include/net/net_if.h>

Release network interface IPv4 config.

Parameters
ifaceInterface to use.
Returns
0 if ok, <0 if error

◆ net_if_config_ipv6_get()

int net_if_config_ipv6_get ( struct net_if iface,
struct net_if_ipv6 **  ipv6 
)

#include <include/net/net_if.h>

Allocate network interface IPv6 config.

This function will allocate new IPv6 config.

Parameters
ifaceInterface to use.
ipv6Pointer to allocated IPv6 struct is returned to caller.
Returns
0 if ok, <0 if error

◆ net_if_config_ipv6_put()

int net_if_config_ipv6_put ( struct net_if iface)

#include <include/net/net_if.h>

Release network interface IPv6 config.

Parameters
ifaceInterface to use.
Returns
0 if ok, <0 if error

◆ net_if_down()

int net_if_down ( struct net_if iface)

#include <include/net/net_if.h>

Bring interface down.

Parameters
ifacePointer to network interface
Returns
0 on success

◆ net_if_flag_clear()

static void net_if_flag_clear ( struct net_if iface,
enum net_if_flag  value 
)
inlinestatic

#include <include/net/net_if.h>

Clear a value in network interface flags.

Parameters
ifacePointer to network interface
valueFlag value

◆ net_if_flag_is_set()

static bool net_if_flag_is_set ( struct net_if iface,
enum net_if_flag  value 
)
inlinestatic

#include <include/net/net_if.h>

Check if a value in network interface flags is set.

Parameters
ifacePointer to network interface
valueFlag value
Returns
True if the value is set, false otherwise

◆ net_if_flag_set()

static void net_if_flag_set ( struct net_if iface,
enum net_if_flag  value 
)
inlinestatic

#include <include/net/net_if.h>

Set a value in network interface flags.

Parameters
ifacePointer to network interface
valueFlag value

◆ net_if_flag_test_and_set()

static bool net_if_flag_test_and_set ( struct net_if iface,
enum net_if_flag  value 
)
inlinestatic

#include <include/net/net_if.h>

Test and set a value in network interface flags.

Parameters
ifacePointer to network interface
valueFlag value
Returns
true if the bit was set, false if it wasn't.

◆ net_if_foreach()

void net_if_foreach ( net_if_cb_t  cb,
void user_data 
)

#include <include/net/net_if.h>

Go through all the network interfaces and call callback for each interface.

Parameters
cbUser-supplied callback function to call
user_dataUser specified data

◆ net_if_get_by_iface()

int net_if_get_by_iface ( struct net_if iface)

#include <include/net/net_if.h>

Get interface index according to pointer.

Parameters
ifacePointer to network interface
Returns
Interface index

◆ net_if_get_by_index()

struct net_if * net_if_get_by_index ( int  index)

#include <include/net/net_if.h>

Get interface according to index.

This is a syscall only to provide access to the object for purposes of assigning permissions.

Parameters
indexInterface index
Returns
Pointer to interface or NULL if not found.

◆ net_if_get_by_link_addr()

struct net_if * net_if_get_by_link_addr ( struct net_linkaddr ll_addr)

#include <include/net/net_if.h>

Get an interface according to link layer address.

Parameters
ll_addrLink layer address.
Returns
Network interface or NULL if not found.

◆ net_if_get_config()

static struct net_if_config * net_if_get_config ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Return network configuration for this network interface.

Parameters
ifacePointer to a network interface structure
Returns
Pointer to configuration

◆ net_if_get_default()

struct net_if * net_if_get_default ( void  )

#include <include/net/net_if.h>

Get the default network interface.

Returns
Default interface or NULL if no interfaces are configured.

◆ net_if_get_device()

static const struct device * net_if_get_device ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Get an network interface's device.

Parameters
ifacePointer to a network interface structure
Returns
a pointer to the device driver instance

◆ net_if_get_first_by_type()

struct net_if * net_if_get_first_by_type ( const struct net_l2 l2)

#include <include/net/net_if.h>

Get the first network interface according to its type.

Parameters
l2Layer 2 type of the network interface.
Returns
First network interface of a given type or NULL if no such interfaces was found.

◆ net_if_get_link_addr()

static struct net_linkaddr * net_if_get_link_addr ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Get an network interface's link address.

Parameters
ifacePointer to a network interface structure
Returns
a pointer to the network link address

◆ net_if_get_mtu()

static uint16_t net_if_get_mtu ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Get an network interface's MTU.

Parameters
ifacePointer to a network interface structure
Returns
the MTU

◆ net_if_ipv4_addr_add()

struct net_if_addr * net_if_ipv4_addr_add ( struct net_if iface,
struct in_addr addr,
enum net_addr_type  addr_type,
uint32_t  vlifetime 
)

#include <include/net/net_if.h>

Add a IPv4 address to an interface.

Parameters
ifaceNetwork interface
addrIPv4 address
addr_typeIPv4 address type
vlifetimeValidity time for this address
Returns
Pointer to interface address, NULL if cannot be added

◆ net_if_ipv4_addr_add_by_index()

bool net_if_ipv4_addr_add_by_index ( int  index,
struct in_addr addr,
enum net_addr_type  addr_type,
uint32_t  vlifetime 
)

#include <include/net/net_if.h>

Add a IPv4 address to an interface by network interface index.

Parameters
indexNetwork interface index
addrIPv4 address
addr_typeIPv4 address type
vlifetimeValidity time for this address
Returns
True if ok, false if the address could not be added

◆ net_if_ipv4_addr_lookup()

struct net_if_addr * net_if_ipv4_addr_lookup ( const struct in_addr addr,
struct net_if **  iface 
)

#include <include/net/net_if.h>

Check if this IPv4 address belongs to one of the interfaces.

Parameters
addrIPv4 address
ifaceInterface is returned
Returns
Pointer to interface address, NULL if not found.

◆ net_if_ipv4_addr_lookup_by_index()

int net_if_ipv4_addr_lookup_by_index ( const struct in_addr addr)

#include <include/net/net_if.h>

Check if this IPv4 address belongs to one of the interface indices.

Parameters
addrIPv4 address
Returns
>0 if address was found in given network interface index, all other values mean address was not found

◆ net_if_ipv4_addr_mask_cmp()

bool net_if_ipv4_addr_mask_cmp ( struct net_if iface,
const struct in_addr addr 
)

#include <include/net/net_if.h>

Check if the given IPv4 address belongs to local subnet.

Parameters
ifaceInterface to use. Must be a valid pointer to an interface.
addrIPv4 address
Returns
True if address is part of local subnet, false otherwise.

◆ net_if_ipv4_addr_rm()

bool net_if_ipv4_addr_rm ( struct net_if iface,
const struct in_addr addr 
)

#include <include/net/net_if.h>

Remove a IPv4 address from an interface.

Parameters
ifaceNetwork interface
addrIPv4 address
Returns
True if successfully removed, false otherwise

◆ net_if_ipv4_addr_rm_by_index()

bool net_if_ipv4_addr_rm_by_index ( int  index,
const struct in_addr addr 
)

#include <include/net/net_if.h>

Remove a IPv4 address from an interface by interface index.

Parameters
indexNetwork interface index
addrIPv4 address
Returns
True if successfully removed, false otherwise

◆ net_if_ipv4_get_global_addr()

struct in_addr * net_if_ipv4_get_global_addr ( struct net_if iface,
enum net_addr_state  addr_state 
)

#include <include/net/net_if.h>

Get a IPv4 global address in a given state.

Parameters
ifaceInterface to use. Must be a valid pointer to an interface.
addr_stateIPv4 address state (preferred, tentative, deprecated)
Returns
Pointer to link local IPv4 address, NULL if no proper IPv4 address could be found.

◆ net_if_ipv4_get_ll()

struct in_addr * net_if_ipv4_get_ll ( struct net_if iface,
enum net_addr_state  addr_state 
)

#include <include/net/net_if.h>

Get a IPv4 link local address in a given state.

Parameters
ifaceInterface to use. Must be a valid pointer to an interface.
addr_stateIPv4 address state (preferred, tentative, deprecated)
Returns
Pointer to link local IPv4 address, NULL if no proper IPv4 address could be found.

◆ net_if_ipv4_get_ttl()

uint8_t net_if_ipv4_get_ttl ( struct net_if iface)

#include <include/net/net_if.h>

Get IPv4 time-to-live value specified for a given interface.

Parameters
ifaceNetwork interface
Returns
Time-to-live

◆ net_if_ipv4_is_addr_bcast()

bool net_if_ipv4_is_addr_bcast ( struct net_if iface,
const struct in_addr addr 
)

#include <include/net/net_if.h>

Check if the given IPv4 address is a broadcast address.

Parameters
ifaceInterface to use. Must be a valid pointer to an interface.
addrIPv4 address, this should be in network byte order
Returns
True if address is a broadcast address, false otherwise.

◆ net_if_ipv4_maddr_add()

struct net_if_mcast_addr * net_if_ipv4_maddr_add ( struct net_if iface,
const struct in_addr addr 
)

#include <include/net/net_if.h>

Add a IPv4 multicast address to an interface.

Parameters
ifaceNetwork interface
addrIPv4 multicast address
Returns
Pointer to interface multicast address, NULL if cannot be added

◆ net_if_ipv4_maddr_is_joined()

static bool net_if_ipv4_maddr_is_joined ( struct net_if_mcast_addr addr)
inlinestatic

#include <include/net/net_if.h>

Check if given multicast address is joined or not.

Parameters
addrIPv4 multicast address
Returns
True if address is joined, False otherwise.

◆ net_if_ipv4_maddr_join()

void net_if_ipv4_maddr_join ( struct net_if_mcast_addr addr)

#include <include/net/net_if.h>

Mark a given multicast address to be joined.

Parameters
addrIPv4 multicast address

◆ net_if_ipv4_maddr_leave()

void net_if_ipv4_maddr_leave ( struct net_if_mcast_addr addr)

#include <include/net/net_if.h>

Mark a given multicast address to be left.

Parameters
addrIPv4 multicast address

◆ net_if_ipv4_maddr_lookup()

struct net_if_mcast_addr * net_if_ipv4_maddr_lookup ( const struct in_addr addr,
struct net_if **  iface 
)

#include <include/net/net_if.h>

Check if this IPv4 multicast address belongs to a specific interface or one of the interfaces.

Parameters
addrIPv4 address
ifaceIf *iface is null, then pointer to interface is returned, otherwise the *iface value needs to be matched.
Returns
Pointer to interface multicast address, NULL if not found.

◆ net_if_ipv4_maddr_rm()

bool net_if_ipv4_maddr_rm ( struct net_if iface,
const struct in_addr addr 
)

#include <include/net/net_if.h>

Remove an IPv4 multicast address from an interface.

Parameters
ifaceNetwork interface
addrIPv4 multicast address
Returns
True if successfully removed, false otherwise

◆ net_if_ipv4_router_add()

struct net_if_router * net_if_ipv4_router_add ( struct net_if iface,
struct in_addr addr,
bool  is_default,
uint16_t  router_lifetime 
)

#include <include/net/net_if.h>

Add IPv4 router to the system.

Parameters
ifaceNetwork interface
addrIPv4 address
is_defaultIs this router the default one
router_lifetimeLifetime of the router
Returns
Pointer to router information, NULL if could not be added

◆ net_if_ipv4_router_find_default()

struct net_if_router * net_if_ipv4_router_find_default ( struct net_if iface,
struct in_addr addr 
)

#include <include/net/net_if.h>

Find default router for this IPv4 address.

Parameters
ifaceNetwork interface. This can be NULL in which case we go through all the network interfaces to find a suitable router.
addrIPv4 address
Returns
Pointer to router information, NULL if cannot be found

◆ net_if_ipv4_router_lookup()

struct net_if_router * net_if_ipv4_router_lookup ( struct net_if iface,
struct in_addr addr 
)

#include <include/net/net_if.h>

Check if IPv4 address is one of the routers configured in the system.

Parameters
ifaceNetwork interface
addrIPv4 address
Returns
Pointer to router information, NULL if cannot be found

◆ net_if_ipv4_router_rm()

bool net_if_ipv4_router_rm ( struct net_if_router router)

#include <include/net/net_if.h>

Remove IPv4 router from the system.

Parameters
routerRouter information.
Returns
True if successfully removed, false otherwise

◆ net_if_ipv4_select_src_addr()

static const struct in_addr * net_if_ipv4_select_src_addr ( struct net_if iface,
const struct in_addr dst 
)
inlinestatic

#include <include/net/net_if.h>

Get a IPv4 source address that should be used when sending network data to destination.

Parameters
ifaceInterface to use when sending the packet. If the interface is not known, then NULL can be given.
dstIPv4 destination address
Returns
Pointer to IPv4 address to use, NULL if no IPv4 address could be found.

◆ net_if_ipv4_select_src_iface()

static struct net_if * net_if_ipv4_select_src_iface ( const struct in_addr dst)
inlinestatic

#include <include/net/net_if.h>

Get a network interface that should be used when sending IPv4 network data to destination.

Parameters
dstIPv4 destination address
Returns
Pointer to network interface to use, NULL if no suitable interface could be found.

◆ net_if_ipv4_set_gw()

void net_if_ipv4_set_gw ( struct net_if iface,
const struct in_addr gw 
)

#include <include/net/net_if.h>

Set IPv4 gateway for an interface.

Parameters
ifaceInterface to use.
gwIPv4 address of an gateway

◆ net_if_ipv4_set_gw_by_index()

bool net_if_ipv4_set_gw_by_index ( int  index,
const struct in_addr gw 
)

#include <include/net/net_if.h>

Set IPv4 gateway for an interface index.

Parameters
indexNetwork interface index
gwIPv4 address of an gateway
Returns
True if gateway was added, false otherwise.

◆ net_if_ipv4_set_netmask()

void net_if_ipv4_set_netmask ( struct net_if iface,
const struct in_addr netmask 
)

#include <include/net/net_if.h>

Set IPv4 netmask for an interface.

Parameters
ifaceInterface to use.
netmaskIPv4 netmask

◆ net_if_ipv4_set_netmask_by_index()

bool net_if_ipv4_set_netmask_by_index ( int  index,
const struct in_addr netmask 
)

#include <include/net/net_if.h>

Set IPv4 netmask for an interface index.

Parameters
indexNetwork interface index
netmaskIPv4 netmask
Returns
True if netmask was added, false otherwise.

◆ net_if_ipv4_set_ttl()

void net_if_ipv4_set_ttl ( struct net_if iface,
uint8_t  ttl 
)

#include <include/net/net_if.h>

Set IPv4 time-to-live value specified to a given interface.

Parameters
ifaceNetwork interface
ttlTime-to-live value

◆ net_if_ipv6_addr_add()

struct net_if_addr * net_if_ipv6_addr_add ( struct net_if iface,
struct in6_addr addr,
enum net_addr_type  addr_type,
uint32_t  vlifetime 
)

#include <include/net/net_if.h>

Add a IPv6 address to an interface.

Parameters
ifaceNetwork interface
addrIPv6 address
addr_typeIPv6 address type
vlifetimeValidity time for this address
Returns
Pointer to interface address, NULL if cannot be added

◆ net_if_ipv6_addr_add_by_index()

bool net_if_ipv6_addr_add_by_index ( int  index,
struct in6_addr addr,
enum net_addr_type  addr_type,
uint32_t  vlifetime 
)

#include <include/net/net_if.h>

Add a IPv6 address to an interface by index.

Parameters
indexNetwork interface index
addrIPv6 address
addr_typeIPv6 address type
vlifetimeValidity time for this address
Returns
True if ok, false if address could not be added

◆ net_if_ipv6_addr_lookup()

struct net_if_addr * net_if_ipv6_addr_lookup ( const struct in6_addr addr,
struct net_if **  iface 
)

#include <include/net/net_if.h>

Check if this IPv6 address belongs to one of the interfaces.

Parameters
addrIPv6 address
ifacePointer to interface is returned
Returns
Pointer to interface address, NULL if not found.

◆ net_if_ipv6_addr_lookup_by_iface()

struct net_if_addr * net_if_ipv6_addr_lookup_by_iface ( struct net_if iface,
struct in6_addr addr 
)

#include <include/net/net_if.h>

Check if this IPv6 address belongs to this specific interfaces.

Parameters
ifaceNetwork interface
addrIPv6 address
Returns
Pointer to interface address, NULL if not found.

◆ net_if_ipv6_addr_lookup_by_index()

int net_if_ipv6_addr_lookup_by_index ( const struct in6_addr addr)

#include <include/net/net_if.h>

Check if this IPv6 address belongs to one of the interface indices.

Parameters
addrIPv6 address
Returns
>0 if address was found in given network interface index, all other values mean address was not found

◆ net_if_ipv6_addr_onlink()

bool net_if_ipv6_addr_onlink ( struct net_if **  iface,
struct in6_addr addr 
)

#include <include/net/net_if.h>

Check if this IPv6 address is part of the subnet of our network interface.

Parameters
ifaceNetwork interface. This is returned to the caller. The iface can be NULL in which case we check all the interfaces.
addrIPv6 address
Returns
True if address is part of our subnet, false otherwise

◆ net_if_ipv6_addr_rm()

bool net_if_ipv6_addr_rm ( struct net_if iface,
const struct in6_addr addr 
)

#include <include/net/net_if.h>

Remove an IPv6 address from an interface.

Parameters
ifaceNetwork interface
addrIPv6 address
Returns
True if successfully removed, false otherwise

◆ net_if_ipv6_addr_rm_by_index()

bool net_if_ipv6_addr_rm_by_index ( int  index,
const struct in6_addr addr 
)

#include <include/net/net_if.h>

Remove an IPv6 address from an interface by index.

Parameters
indexNetwork interface index
addrIPv6 address
Returns
True if successfully removed, false otherwise

◆ net_if_ipv6_addr_update_lifetime()

void net_if_ipv6_addr_update_lifetime ( struct net_if_addr ifaddr,
uint32_t  vlifetime 
)

#include <include/net/net_if.h>

Update validity lifetime time of an IPv6 address.

Parameters
ifaddrNetwork IPv6 address
vlifetimeValidity time for this address

◆ net_if_ipv6_calc_reachable_time()

uint32_t net_if_ipv6_calc_reachable_time ( struct net_if_ipv6 ipv6)

#include <include/net/net_if.h>

Calculate next reachable time value for IPv6 reachable time.

Parameters
ipv6IPv6 address configuration
Returns
Reachable time

◆ net_if_ipv6_dad_failed()

void net_if_ipv6_dad_failed ( struct net_if iface,
const struct in6_addr addr 
)

#include <include/net/net_if.h>

Stop IPv6 Duplicate Address Detection (DAD) procedure if we find out that our IPv6 address is already in use.

Parameters
ifaceInterface where the DAD was running.
addrIPv6 address that failed DAD

◆ net_if_ipv6_get_global_addr()

struct in6_addr * net_if_ipv6_get_global_addr ( enum net_addr_state  state,
struct net_if **  iface 
)

#include <include/net/net_if.h>

Return global IPv6 address from the first interface that has a global IPv6 address matching the given state.

Parameters
stateIPv6 address state (ANY, TENTATIVE, PREFERRED, DEPRECATED)
ifaceCaller can give an interface to check. If iface is set to NULL, then all the interfaces are checked. Pointer to interface where the IPv6 address is defined is returned to the caller.
Returns
Pointer to IPv6 address, NULL if not found.

◆ net_if_ipv6_get_hop_limit()

uint8_t net_if_ipv6_get_hop_limit ( struct net_if iface)

#include <include/net/net_if.h>

Get IPv6 hop limit specified for a given interface. This is the default value but can be overridden by the user.

Parameters
ifaceNetwork interface
Returns
Hop limit

◆ net_if_ipv6_get_ll()

struct in6_addr * net_if_ipv6_get_ll ( struct net_if iface,
enum net_addr_state  addr_state 
)

#include <include/net/net_if.h>

Get a IPv6 link local address in a given state.

Parameters
ifaceInterface to use. Must be a valid pointer to an interface.
addr_stateIPv6 address state (preferred, tentative, deprecated)
Returns
Pointer to link local IPv6 address, NULL if no proper IPv6 address could be found.

◆ net_if_ipv6_get_ll_addr()

struct in6_addr * net_if_ipv6_get_ll_addr ( enum net_addr_state  state,
struct net_if **  iface 
)

#include <include/net/net_if.h>

Return link local IPv6 address from the first interface that has a link local address matching give state.

Parameters
stateIPv6 address state (ANY, TENTATIVE, PREFERRED, DEPRECATED)
ifacePointer to interface is returned
Returns
Pointer to IPv6 address, NULL if not found.

◆ net_if_ipv6_get_reachable_time()

static uint32_t net_if_ipv6_get_reachable_time ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Get IPv6 reachable timeout specified for a given interface.

Parameters
ifaceNetwork interface
Returns
Reachable timeout

◆ net_if_ipv6_get_retrans_timer()

static uint32_t net_if_ipv6_get_retrans_timer ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Get IPv6 retransmit timer specified for a given interface.

Parameters
ifaceNetwork interface
Returns
Retransmit timer

◆ net_if_ipv6_maddr_add()

struct net_if_mcast_addr * net_if_ipv6_maddr_add ( struct net_if iface,
const struct in6_addr addr 
)

#include <include/net/net_if.h>

Add a IPv6 multicast address to an interface.

Parameters
ifaceNetwork interface
addrIPv6 multicast address
Returns
Pointer to interface multicast address, NULL if cannot be added

◆ net_if_ipv6_maddr_is_joined()

static bool net_if_ipv6_maddr_is_joined ( struct net_if_mcast_addr addr)
inlinestatic

#include <include/net/net_if.h>

Check if given multicast address is joined or not.

Parameters
addrIPv6 multicast address
Returns
True if address is joined, False otherwise.

◆ net_if_ipv6_maddr_join()

void net_if_ipv6_maddr_join ( struct net_if_mcast_addr addr)

#include <include/net/net_if.h>

Mark a given multicast address to be joined.

Parameters
addrIPv6 multicast address

◆ net_if_ipv6_maddr_leave()

void net_if_ipv6_maddr_leave ( struct net_if_mcast_addr addr)

#include <include/net/net_if.h>

Mark a given multicast address to be left.

Parameters
addrIPv6 multicast address

◆ net_if_ipv6_maddr_lookup()

struct net_if_mcast_addr * net_if_ipv6_maddr_lookup ( const struct in6_addr addr,
struct net_if **  iface 
)

#include <include/net/net_if.h>

Check if this IPv6 multicast address belongs to a specific interface or one of the interfaces.

Parameters
addrIPv6 address
ifaceIf *iface is null, then pointer to interface is returned, otherwise the *iface value needs to be matched.
Returns
Pointer to interface multicast address, NULL if not found.

◆ net_if_ipv6_maddr_rm()

bool net_if_ipv6_maddr_rm ( struct net_if iface,
const struct in6_addr addr 
)

#include <include/net/net_if.h>

Remove an IPv6 multicast address from an interface.

Parameters
ifaceNetwork interface
addrIPv6 multicast address
Returns
True if successfully removed, false otherwise

◆ net_if_ipv6_prefix_add()

struct net_if_ipv6_prefix * net_if_ipv6_prefix_add ( struct net_if iface,
struct in6_addr prefix,
uint8_t  len,
uint32_t  lifetime 
)

#include <include/net/net_if.h>

Add a IPv6 prefix to an network interface.

Parameters
ifaceNetwork interface
prefixIPv6 address
lenPrefix length
lifetimePrefix lifetime in seconds
Returns
Pointer to prefix, NULL if the prefix was not added.

◆ net_if_ipv6_prefix_get()

struct net_if_ipv6_prefix * net_if_ipv6_prefix_get ( struct net_if iface,
struct in6_addr addr 
)

#include <include/net/net_if.h>

Return prefix that corresponds to this IPv6 address.

Parameters
ifaceNetwork interface
addrIPv6 address
Returns
Pointer to prefix, NULL if not found.

◆ net_if_ipv6_prefix_lookup()

struct net_if_ipv6_prefix * net_if_ipv6_prefix_lookup ( struct net_if iface,
struct in6_addr addr,
uint8_t  len 
)

#include <include/net/net_if.h>

Check if this IPv6 prefix belongs to this interface.

Parameters
ifaceNetwork interface
addrIPv6 address
lenPrefix length
Returns
Pointer to prefix, NULL if not found.

◆ net_if_ipv6_prefix_rm()

bool net_if_ipv6_prefix_rm ( struct net_if iface,
struct in6_addr addr,
uint8_t  len 
)

#include <include/net/net_if.h>

Remove an IPv6 prefix from an interface.

Parameters
ifaceNetwork interface
addrIPv6 prefix address
lenPrefix length
Returns
True if successfully removed, false otherwise

◆ net_if_ipv6_prefix_set_lf()

static void net_if_ipv6_prefix_set_lf ( struct net_if_ipv6_prefix prefix,
bool  is_infinite 
)
inlinestatic

#include <include/net/net_if.h>

Set the infinite status of the prefix.

Parameters
prefixIPv6 address
is_infiniteInfinite status

◆ net_if_ipv6_prefix_set_timer()

void net_if_ipv6_prefix_set_timer ( struct net_if_ipv6_prefix prefix,
uint32_t  lifetime 
)

#include <include/net/net_if.h>

Set the prefix lifetime timer.

Parameters
prefixIPv6 address
lifetimePrefix lifetime in seconds

◆ net_if_ipv6_prefix_unset_timer()

void net_if_ipv6_prefix_unset_timer ( struct net_if_ipv6_prefix prefix)

#include <include/net/net_if.h>

Unset the prefix lifetime timer.

Parameters
prefixIPv6 address

◆ net_if_ipv6_router_add()

struct net_if_router * net_if_ipv6_router_add ( struct net_if iface,
struct in6_addr addr,
uint16_t  router_lifetime 
)

#include <include/net/net_if.h>

Add IPv6 router to the system.

Parameters
ifaceNetwork interface
addrIPv6 address
router_lifetimeLifetime of the router
Returns
Pointer to router information, NULL if could not be added

◆ net_if_ipv6_router_find_default()

struct net_if_router * net_if_ipv6_router_find_default ( struct net_if iface,
struct in6_addr addr 
)

#include <include/net/net_if.h>

Find default router for this IPv6 address.

Parameters
ifaceNetwork interface. This can be NULL in which case we go through all the network interfaces to find a suitable router.
addrIPv6 address
Returns
Pointer to router information, NULL if cannot be found

◆ net_if_ipv6_router_lookup()

struct net_if_router * net_if_ipv6_router_lookup ( struct net_if iface,
struct in6_addr addr 
)

#include <include/net/net_if.h>

Check if IPv6 address is one of the routers configured in the system.

Parameters
ifaceNetwork interface
addrIPv6 address
Returns
Pointer to router information, NULL if cannot be found

◆ net_if_ipv6_router_rm()

bool net_if_ipv6_router_rm ( struct net_if_router router)

#include <include/net/net_if.h>

Remove IPv6 router from the system.

Parameters
routerRouter information.
Returns
True if successfully removed, false otherwise

◆ net_if_ipv6_router_update_lifetime()

void net_if_ipv6_router_update_lifetime ( struct net_if_router router,
uint16_t  lifetime 
)

#include <include/net/net_if.h>

Update validity lifetime time of a router.

Parameters
routerNetwork IPv6 address
lifetimeLifetime of this router.

◆ net_if_ipv6_select_src_addr()

static const struct in6_addr * net_if_ipv6_select_src_addr ( struct net_if iface,
const struct in6_addr dst 
)
inlinestatic

#include <include/net/net_if.h>

Get a IPv6 source address that should be used when sending network data to destination.

Parameters
ifaceInterface that was used when packet was received. If the interface is not known, then NULL can be given.
dstIPv6 destination address
Returns
Pointer to IPv6 address to use, NULL if no IPv6 address could be found.

◆ net_if_ipv6_select_src_iface()

static struct net_if * net_if_ipv6_select_src_iface ( const struct in6_addr dst)
inlinestatic

#include <include/net/net_if.h>

Get a network interface that should be used when sending IPv6 network data to destination.

Parameters
dstIPv6 destination address
Returns
Pointer to network interface to use, NULL if no suitable interface could be found.

◆ net_if_ipv6_set_base_reachable_time()

static void net_if_ipv6_set_base_reachable_time ( struct net_if iface,
uint32_t  reachable_time 
)
inlinestatic

#include <include/net/net_if.h>

Set IPv6 reachable time for a given interface.

Parameters
ifaceNetwork interface
reachable_timeNew reachable time

◆ net_if_ipv6_set_reachable_time()

static void net_if_ipv6_set_reachable_time ( struct net_if_ipv6 ipv6)
inlinestatic

#include <include/net/net_if.h>

Set IPv6 reachable time for a given interface. This requires that base reachable time is set for the interface.

Parameters
ipv6IPv6 address configuration

◆ net_if_ipv6_set_retrans_timer()

static void net_if_ipv6_set_retrans_timer ( struct net_if iface,
uint32_t  retrans_timer 
)
inlinestatic

#include <include/net/net_if.h>

Set IPv6 retransmit timer for a given interface.

Parameters
ifaceNetwork interface
retrans_timerNew retransmit timer

◆ net_if_is_ip_offloaded()

static bool net_if_is_ip_offloaded ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Return the IP offload status.

Parameters
ifaceNetwork interface
Returns
True if IP offlining is active, false otherwise.

◆ net_if_is_promisc()

bool net_if_is_promisc ( struct net_if iface)

#include <include/net/net_if.h>

Check if promiscuous mode is set or not.

Parameters
ifacePointer to network interface
Returns
True if interface is in promisc mode, False if interface is not in in promiscuous mode.

◆ net_if_is_socket_offloaded()

static bool net_if_is_socket_offloaded ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Return the socket offload status.

Parameters
ifaceNetwork interface
Returns
True if socket offloading is active, false otherwise.

◆ net_if_is_up()

static bool net_if_is_up ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Check if interface is up.

Parameters
ifacePointer to network interface
Returns
True if interface is up, False if it is down.

◆ net_if_l2()

static const struct net_l2 *const net_if_l2 ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Get a pointer to the interface L2.

Parameters
ifacea valid pointer to a network interface structure
Returns
a pointer to the iface L2

◆ net_if_l2_data()

static void * net_if_l2_data ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Get a pointer to the interface L2 private data.

Parameters
ifacea valid pointer to a network interface structure
Returns
a pointer to the iface L2 data

◆ net_if_lookup_by_dev()

struct net_if * net_if_lookup_by_dev ( const struct device dev)

#include <include/net/net_if.h>

Find an interface from it's related device.

Parameters
devA valid struct device pointer to relate with an interface
Returns
a valid struct net_if pointer on success, NULL otherwise

◆ net_if_mcast_mon_register()

void net_if_mcast_mon_register ( struct net_if_mcast_monitor mon,
struct net_if iface,
net_if_mcast_callback_t  cb 
)

#include <include/net/net_if.h>

Register a multicast monitor.

Parameters
monMonitor handle. This is a pointer to a monitor storage structure which should be allocated by caller, but does not need to be initialized.
ifaceNetwork interface
cbMonitor callback

◆ net_if_mcast_mon_unregister()

void net_if_mcast_mon_unregister ( struct net_if_mcast_monitor mon)

#include <include/net/net_if.h>

Unregister a multicast monitor.

Parameters
monMonitor handle

◆ net_if_mcast_monitor()

void net_if_mcast_monitor ( struct net_if iface,
const struct in6_addr addr,
bool  is_joined 
)

#include <include/net/net_if.h>

Call registered multicast monitors.

Parameters
ifaceNetwork interface
addrMulticast address
is_joinedIs this multicast address joined (true) or not (false)

◆ net_if_need_calc_rx_checksum()

bool net_if_need_calc_rx_checksum ( struct net_if iface)

#include <include/net/net_if.h>

Check if received network packet checksum calculation can be avoided or not. For example many ethernet devices support network packet offloading in which case the IP stack does not need to calculate the checksum.

Parameters
ifaceNetwork interface
Returns
True if checksum needs to be calculated, false otherwise.

◆ net_if_need_calc_tx_checksum()

bool net_if_need_calc_tx_checksum ( struct net_if iface)

#include <include/net/net_if.h>

Check if network packet checksum calculation can be avoided or not when sending the packet. For example many ethernet devices support network packet offloading in which case the IP stack does not need to calculate the checksum.

Parameters
ifaceNetwork interface
Returns
True if checksum needs to be calculated, false otherwise.

◆ net_if_offload()

static struct net_offload * net_if_offload ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Return the IP offload plugin.

Parameters
ifaceNetwork interface
Returns
NULL if there is no offload plugin defined, valid pointer otherwise

◆ net_if_queue_tx()

void net_if_queue_tx ( struct net_if iface,
struct net_pkt pkt 
)

#include <include/net/net_if.h>

Queue a packet to the net interface TX queue.

Parameters
ifacePointer to a network interface structure
pktPointer to a net packet to queue

◆ net_if_recv_data()

enum net_verdict net_if_recv_data ( struct net_if iface,
struct net_pkt pkt 
)

#include <include/net/net_if.h>

Input a packet through a net iface.

Parameters
ifacePointer to a network interface structure
pktPointer to a net packet to input
Returns
verdict about the packet

◆ net_if_register_link_cb()

void net_if_register_link_cb ( struct net_if_link_cb link,
net_if_link_callback_t  cb 
)

#include <include/net/net_if.h>

Register a link callback.

Parameters
linkCaller specified handler for the callback.
cbCallback to register.

◆ net_if_router_ipv4()

static struct in_addr * net_if_router_ipv4 ( struct net_if_router router)
inlinestatic

#include <include/net/net_if.h>

Get the IPv4 address of the given router.

Parameters
routera network router
Returns
pointer to the IPv4 address, or NULL if none

◆ net_if_router_ipv6()

static struct in6_addr * net_if_router_ipv6 ( struct net_if_router router)
inlinestatic

#include <include/net/net_if.h>

Get the IPv6 address of the given router.

Parameters
routera network router
Returns
pointer to the IPv6 address, or NULL if none

◆ net_if_router_rm()

void net_if_router_rm ( struct net_if_router router)

#include <include/net/net_if.h>

Remove a router from the system.

Parameters
routerPointer to existing router

◆ net_if_select_src_iface()

struct net_if * net_if_select_src_iface ( const struct sockaddr dst)

#include <include/net/net_if.h>

Get a network interface that should be used when sending IPv6 or IPv4 network data to destination.

Parameters
dstIPv6 or IPv4 destination address
Returns
Pointer to network interface to use. Note that the function will return the default network interface if the best network interface is not found.

◆ net_if_send_data()

enum net_verdict net_if_send_data ( struct net_if iface,
struct net_pkt pkt 
)

#include <include/net/net_if.h>

Send a packet through a net iface.

Parameters
ifacePointer to a network interface structure
pktPointer to a net packet to send

return verdict about the packet

◆ net_if_set_link_addr()

static int net_if_set_link_addr ( struct net_if iface,
uint8_t addr,
uint8_t  len,
enum net_link_type  type 
)
inlinestatic

#include <include/net/net_if.h>

Set a network interface's link address.

Parameters
ifacePointer to a network interface structure
addrA pointer to a uint8_t buffer representing the address. The buffer must remain valid throughout interface lifetime.
lenlength of the address buffer
typenetwork bearer type of this link address
Returns
0 on success

◆ net_if_set_mtu()

static void net_if_set_mtu ( struct net_if iface,
uint16_t  mtu 
)
inlinestatic

#include <include/net/net_if.h>

Set an network interface's MTU.

Parameters
ifacePointer to a network interface structure
mtuNew MTU, note that we store only 16 bit mtu value.

◆ net_if_set_promisc()

int net_if_set_promisc ( struct net_if iface)

#include <include/net/net_if.h>

Set network interface into promiscuous mode.

Note that not all network technologies will support this.

Parameters
ifacePointer to network interface
Returns
0 on success, <0 if error

◆ net_if_start_dad()

static void net_if_start_dad ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Start duplicate address detection procedure.

Parameters
ifacePointer to a network interface structure

◆ net_if_start_rs()

void net_if_start_rs ( struct net_if iface)

#include <include/net/net_if.h>

Start neighbor discovery and send router solicitation message.

Parameters
ifacePointer to a network interface structure

◆ net_if_stop_rs()

static void net_if_stop_rs ( struct net_if iface)
inlinestatic

#include <include/net/net_if.h>

Stop neighbor discovery.

Parameters
ifacePointer to a network interface structure

◆ net_if_unregister_link_cb()

void net_if_unregister_link_cb ( struct net_if_link_cb link)

#include <include/net/net_if.h>

Unregister a link callback.

Parameters
linkCaller specified handler for the callback.

◆ net_if_unset_promisc()

void net_if_unset_promisc ( struct net_if iface)

#include <include/net/net_if.h>

Set network interface into normal mode.

Parameters
ifacePointer to network interface

◆ net_if_up()

int net_if_up ( struct net_if iface)

#include <include/net/net_if.h>

Bring interface up.

Parameters
ifacePointer to network interface
Returns
0 on success

◆ net_ipv6_set_hop_limit()

void net_ipv6_set_hop_limit ( struct net_if iface,
uint8_t  hop_limit 
)

#include <include/net/net_if.h>

Set the default IPv6 hop limit of a given interface.

Parameters
ifaceNetwork interface
hop_limitNew hop limit