net_if.h

Go to the documentation of this file.

/*
 * Copyright (c) 2016 Intel Corporation.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_NET_NET_IF_H_
#define ZEPHYR_INCLUDE_NET_NET_IF_H_
 
#include <zephyr/device.h>
#include <zephyr/sys/slist.h>
 
#include <zephyr/net/net_core.h>
#include <zephyr/net/hostname.h>
#include <zephyr/net/net_linkaddr.h>
#include <zephyr/net/net_ip.h>
#include <zephyr/net/net_l2.h>
#include <zephyr/net/net_stats.h>
#include <zephyr/net/net_timeout.h>
 
#if defined(CONFIG_NET_DHCPV4) && defined(CONFIG_NET_NATIVE_IPV4)
#include <zephyr/net/dhcpv4.h>
#endif
#if defined(CONFIG_NET_IPV4_AUTO) && defined(CONFIG_NET_NATIVE_IPV4)
#include <zephyr/net/ipv4_autoconf.h>
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct net_if_addr {
        struct net_addr address;
 
#if defined(CONFIG_NET_NATIVE_IPV6)
        struct net_timeout lifetime;
#endif
 
#if defined(CONFIG_NET_IPV6_DAD) && defined(CONFIG_NET_NATIVE_IPV6)
        sys_snode_t dad_node;
        uint32_t dad_start;
#endif
        enum net_addr_type addr_type;
 
        enum net_addr_state addr_state;
 
#if defined(CONFIG_NET_IPV6_DAD) && defined(CONFIG_NET_NATIVE_IPV6)
        uint8_t dad_count;
#endif
 
        uint8_t is_infinite : 1;
 
        uint8_t is_used : 1;
 
        uint8_t is_mesh_local : 1;
 
        uint8_t _unused : 5;
};
 
struct net_if_mcast_addr {
        struct net_addr address;
 
        uint8_t is_used : 1;
 
        uint8_t is_joined : 1;
 
        uint8_t _unused : 6;
};
 
struct net_if_ipv6_prefix {
        struct net_timeout lifetime;
 
        struct in6_addr prefix;
 
        struct net_if *iface;
 
        uint8_t len;
 
        uint8_t is_infinite : 1;
 
        uint8_t is_used : 1;
 
        uint8_t _unused : 6;
};
 
struct net_if_router {
        sys_snode_t node;
 
        struct net_addr address;
 
        struct net_if *iface;
 
        uint32_t life_start;
 
        uint16_t lifetime;
 
        uint8_t is_used : 1;
 
        uint8_t is_default : 1;
 
        uint8_t is_infinite : 1;
 
        uint8_t _unused : 5;
};
 
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,
 
        /* Total number of flags - must be at the end of the enum */
        NET_IF_NUM_FLAGS
};
 
#if defined(CONFIG_NET_OFFLOAD)
struct net_offload;
#endif /* CONFIG_NET_OFFLOAD */
 
#if defined(CONFIG_NET_NATIVE_IPV6)
#define NET_IF_MAX_IPV6_ADDR CONFIG_NET_IF_UNICAST_IPV6_ADDR_COUNT
#define NET_IF_MAX_IPV6_MADDR CONFIG_NET_IF_MCAST_IPV6_ADDR_COUNT
#define NET_IF_MAX_IPV6_PREFIX CONFIG_NET_IF_IPV6_PREFIX_COUNT
#else
#define NET_IF_MAX_IPV6_ADDR 0
#define NET_IF_MAX_IPV6_MADDR 0
#define NET_IF_MAX_IPV6_PREFIX 0
#endif
/* @endcond */
 
struct net_if_ipv6 {
        struct net_if_addr unicast[NET_IF_MAX_IPV6_ADDR];
 
        struct net_if_mcast_addr mcast[NET_IF_MAX_IPV6_MADDR];
 
        struct net_if_ipv6_prefix prefix[NET_IF_MAX_IPV6_PREFIX];
 
        uint32_t base_reachable_time;
 
        uint32_t reachable_time;
 
        uint32_t retrans_timer;
#if defined(CONFIG_NET_IPV6_ND) && defined(CONFIG_NET_NATIVE_IPV6)
        sys_snode_t rs_node;
 
        /* RS start time */
        uint32_t rs_start;
 
        uint8_t rs_count;
#endif
 
        uint8_t hop_limit;
};
 
#if defined(CONFIG_NET_NATIVE_IPV4)
#define NET_IF_MAX_IPV4_ADDR CONFIG_NET_IF_UNICAST_IPV4_ADDR_COUNT
#define NET_IF_MAX_IPV4_MADDR CONFIG_NET_IF_MCAST_IPV4_ADDR_COUNT
#else
#define NET_IF_MAX_IPV4_ADDR 0
#define NET_IF_MAX_IPV4_MADDR 0
#endif
struct net_if_ipv4 {
        struct net_if_addr unicast[NET_IF_MAX_IPV4_ADDR];
 
        struct net_if_mcast_addr mcast[NET_IF_MAX_IPV4_MADDR];
 
        struct in_addr gw;
 
        struct in_addr netmask;
 
        uint8_t ttl;
};
 
#if defined(CONFIG_NET_DHCPV4) && defined(CONFIG_NET_NATIVE_IPV4)
struct net_if_dhcpv4 {
        sys_snode_t node;
 
        int64_t timer_start;
 
        uint32_t request_time;
 
        uint32_t xid;
 
        uint32_t lease_time;
 
        uint32_t renewal_time;
 
        uint32_t rebinding_time;
 
        struct in_addr server_id;
 
        struct in_addr requested_ip;
 
        enum net_dhcpv4_state state;
 
        uint8_t attempts;
};
#endif /* CONFIG_NET_DHCPV4 */
 
#if defined(CONFIG_NET_IPV4_AUTO) && defined(CONFIG_NET_NATIVE_IPV4)
struct net_if_ipv4_autoconf {
        sys_snode_t node;
 
        struct net_if *iface;
 
        int64_t timer_start;
 
        uint32_t timer_timeout;
 
        struct in_addr current_ip;
 
        struct in_addr requested_ip;
 
        enum net_ipv4_autoconf_state state;
 
        uint8_t probe_cnt;
 
        uint8_t announce_cnt;
 
        uint8_t conflict_cnt;
};
#endif /* CONFIG_NET_IPV4_AUTO */
 
/* We always need to have at least one IP config */
#define NET_IF_MAX_CONFIGS 1
struct net_if_ip {
#if defined(CONFIG_NET_NATIVE_IPV6)
        struct net_if_ipv6 *ipv6;
#endif /* CONFIG_NET_IPV6 */
 
#if defined(CONFIG_NET_NATIVE_IPV4)
        struct net_if_ipv4 *ipv4;
#endif /* CONFIG_NET_IPV4 */
};
 
struct net_if_config {
#if defined(CONFIG_NET_IP)
        struct net_if_ip ip;
#endif
 
#if defined(CONFIG_NET_DHCPV4) && defined(CONFIG_NET_NATIVE_IPV4)
        struct net_if_dhcpv4 dhcpv4;
#endif /* CONFIG_NET_DHCPV4 */
 
#if defined(CONFIG_NET_IPV4_AUTO) && defined(CONFIG_NET_NATIVE_IPV4)
        struct net_if_ipv4_autoconf ipv4auto;
#endif /* CONFIG_NET_IPV4_AUTO */
 
#if defined(CONFIG_NET_L2_VIRTUAL)
        sys_slist_t virtual_interfaces;
#endif /* CONFIG_NET_L2_VIRTUAL */
};
 
struct net_traffic_class {
        struct k_fifo fifo;
 
        struct k_thread handler;
 
        k_thread_stack_t *stack;
};
 
typedef int (*net_socket_create_t)(int, int, int);
 
struct net_if_dev {
        const struct device *dev;
 
        const struct net_l2 * const l2;
 
        void *l2_data;
 
        /* For internal use */
        ATOMIC_DEFINE(flags, NET_IF_NUM_FLAGS);
 
        struct net_linkaddr link_addr;
 
#if defined(CONFIG_NET_OFFLOAD)
        struct net_offload *offload;
#endif /* CONFIG_NET_OFFLOAD */
 
        uint16_t mtu;
 
#if defined(CONFIG_NET_SOCKETS_OFFLOAD)
        net_socket_create_t socket_offload;
#endif /* CONFIG_NET_SOCKETS_OFFLOAD */
};
 
struct net_if {
        struct net_if_dev *if_dev;
 
#if defined(CONFIG_NET_STATISTICS_PER_INTERFACE)
        struct net_stats stats;
#endif /* CONFIG_NET_STATISTICS_PER_INTERFACE */
 
        struct net_if_config config;
 
#if defined(CONFIG_NET_POWER_MANAGEMENT)
        int tx_pending;
#endif
};
 
static inline void net_if_flag_set(struct net_if *iface,
                                   enum net_if_flag value)
{
        NET_ASSERT(iface);
 
        atomic_set_bit(iface->if_dev->flags, value);
}
 
static inline bool net_if_flag_test_and_set(struct net_if *iface,
                                            enum net_if_flag value)
{
        NET_ASSERT(iface);
 
        return atomic_test_and_set_bit(iface->if_dev->flags, value);
}
 
static inline void net_if_flag_clear(struct net_if *iface,
                                     enum net_if_flag value)
{
        NET_ASSERT(iface);
 
        atomic_clear_bit(iface->if_dev->flags, value);
}
 
static inline bool net_if_flag_is_set(struct net_if *iface,
                                      enum net_if_flag value)
{
        if (iface == NULL) {
                return false;
        }
 
        return atomic_test_bit(iface->if_dev->flags, value);
}
 
enum net_verdict net_if_send_data(struct net_if *iface, struct net_pkt *pkt);
 
static inline const struct net_l2 * const net_if_l2(struct net_if *iface)
{
        if (!iface || !iface->if_dev) {
                return NULL;
        }
 
        return iface->if_dev->l2;
}
 
enum net_verdict net_if_recv_data(struct net_if *iface, struct net_pkt *pkt);
 
static inline void *net_if_l2_data(struct net_if *iface)
{
        return iface->if_dev->l2_data;
}
 
static inline const struct device *net_if_get_device(struct net_if *iface)
{
        return iface->if_dev->dev;
}
 
void net_if_queue_tx(struct net_if *iface, struct net_pkt *pkt);
 
static inline bool net_if_is_ip_offloaded(struct net_if *iface)
{
#if defined(CONFIG_NET_OFFLOAD)
        return (iface->if_dev->offload != NULL);
#else
        ARG_UNUSED(iface);
 
        return false;
#endif
}
 
static inline struct net_offload *net_if_offload(struct net_if *iface)
{
#if defined(CONFIG_NET_OFFLOAD)
        return iface->if_dev->offload;
#else
        ARG_UNUSED(iface);
 
        return NULL;
#endif
}
 
static inline bool net_if_is_socket_offloaded(struct net_if *iface)
{
#if defined(CONFIG_NET_SOCKETS_OFFLOAD)
        return (iface->if_dev->socket_offload != NULL);
#else
        ARG_UNUSED(iface);
 
        return false;
#endif
}
 
static inline void net_if_socket_offload_set(
                struct net_if *iface, net_socket_create_t socket_offload)
{
#if defined(CONFIG_NET_SOCKETS_OFFLOAD)
        iface->if_dev->socket_offload = socket_offload;
#else
        ARG_UNUSED(iface);
        ARG_UNUSED(socket_offload);
#endif
}
 
static inline net_socket_create_t net_if_socket_offload(struct net_if *iface)
{
#if defined(CONFIG_NET_SOCKETS_OFFLOAD)
        return iface->if_dev->socket_offload;
#else
        ARG_UNUSED(iface);
 
        return NULL;
#endif
}
 
static inline struct net_linkaddr *net_if_get_link_addr(struct net_if *iface)
{
        return &iface->if_dev->link_addr;
}
 
static inline struct net_if_config *net_if_get_config(struct net_if *iface)
{
        return &iface->config;
}
 
#if defined(CONFIG_NET_IPV6_DAD) && defined(CONFIG_NET_NATIVE_IPV6)
void net_if_start_dad(struct net_if *iface);
#else
static inline void net_if_start_dad(struct net_if *iface)
{
        ARG_UNUSED(iface);
}
#endif
 
void net_if_start_rs(struct net_if *iface);
 
 
#if defined(CONFIG_NET_IPV6_ND) && defined(CONFIG_NET_NATIVE_IPV6)
void net_if_stop_rs(struct net_if *iface);
#else
static inline void net_if_stop_rs(struct net_if *iface)
{
        ARG_UNUSED(iface);
}
#endif /* CONFIG_NET_IPV6_ND */
 
static inline int net_if_set_link_addr_unlocked(struct net_if *iface,
                                                uint8_t *addr, uint8_t len,
                                                enum net_link_type type)
{
        if (net_if_flag_is_set(iface, NET_IF_UP)) {
                return -EPERM;
        }
 
        net_if_get_link_addr(iface)->addr = addr;
        net_if_get_link_addr(iface)->len = len;
        net_if_get_link_addr(iface)->type = type;
 
        net_hostname_set_postfix(addr, len);
 
        return 0;
}
 
int net_if_set_link_addr_locked(struct net_if *iface,
                                uint8_t *addr, uint8_t len,
                                enum net_link_type type);
static inline int net_if_set_link_addr(struct net_if *iface,
                                       uint8_t *addr, uint8_t len,
                                       enum net_link_type type)
{
#if defined(CONFIG_NET_RAW_MODE)
        return net_if_set_link_addr_unlocked(iface, addr, len, type);
#else
        return net_if_set_link_addr_locked(iface, addr, len, type);
#endif
}
 
static inline uint16_t net_if_get_mtu(struct net_if *iface)
{
        if (iface == NULL) {
                return 0U;
        }
 
        return iface->if_dev->mtu;
}
 
static inline void net_if_set_mtu(struct net_if *iface,
                                  uint16_t mtu)
{
        if (iface == NULL) {
                return;
        }
 
        iface->if_dev->mtu = mtu;
}
 
static inline void net_if_addr_set_lf(struct net_if_addr *ifaddr,
                                      bool is_infinite)
{
        ifaddr->is_infinite = is_infinite;
}
 
struct net_if *net_if_get_by_link_addr(struct net_linkaddr *ll_addr);
 
struct net_if *net_if_lookup_by_dev(const struct device *dev);
 
static inline struct net_if_config *net_if_config_get(struct net_if *iface)
{
        return &iface->config;
}
 
void net_if_router_rm(struct net_if_router *router);
 
void net_if_set_default(struct net_if *iface);
 
struct net_if *net_if_get_default(void);
 
struct net_if *net_if_get_first_by_type(const struct net_l2 *l2);
 
struct net_if *net_if_get_first_up(void);
 
#if defined(CONFIG_NET_L2_IEEE802154)
static inline struct net_if *net_if_get_ieee802154(void)
{
        return net_if_get_first_by_type(&NET_L2_GET_NAME(IEEE802154));
}
#endif /* CONFIG_NET_L2_IEEE802154 */
 
int net_if_config_ipv6_get(struct net_if *iface,
                           struct net_if_ipv6 **ipv6);
 
int net_if_config_ipv6_put(struct net_if *iface);
 
struct net_if_addr *net_if_ipv6_addr_lookup(const struct in6_addr *addr,
                                            struct net_if **iface);
 
struct net_if_addr *net_if_ipv6_addr_lookup_by_iface(struct net_if *iface,
                                                     struct in6_addr *addr);
 
__syscall int net_if_ipv6_addr_lookup_by_index(const struct in6_addr *addr);
 
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);
 
__syscall bool net_if_ipv6_addr_add_by_index(int index,
                                             struct in6_addr *addr,
                                             enum net_addr_type addr_type,
                                             uint32_t vlifetime);
 
void net_if_ipv6_addr_update_lifetime(struct net_if_addr *ifaddr,
                                      uint32_t vlifetime);
 
bool net_if_ipv6_addr_rm(struct net_if *iface, const struct in6_addr *addr);
 
__syscall bool net_if_ipv6_addr_rm_by_index(int index,
                                            const struct in6_addr *addr);
 
struct net_if_mcast_addr *net_if_ipv6_maddr_add(struct net_if *iface,
                                                const struct in6_addr *addr);
 
bool net_if_ipv6_maddr_rm(struct net_if *iface, const struct in6_addr *addr);
 
struct net_if_mcast_addr *net_if_ipv6_maddr_lookup(const struct in6_addr *addr,
                                                   struct net_if **iface);
 
typedef void (*net_if_mcast_callback_t)(struct net_if *iface,
                                        const struct net_addr *addr,
                                        bool is_joined);
 
struct net_if_mcast_monitor {
        sys_snode_t node;
 
        struct net_if *iface;
 
        net_if_mcast_callback_t cb;
};
 
void net_if_mcast_mon_register(struct net_if_mcast_monitor *mon,
                               struct net_if *iface,
                               net_if_mcast_callback_t cb);
 
void net_if_mcast_mon_unregister(struct net_if_mcast_monitor *mon);
 
void net_if_mcast_monitor(struct net_if *iface, const struct net_addr *addr,
                          bool is_joined);
 
void net_if_ipv6_maddr_join(struct net_if_mcast_addr *addr);
 
static inline bool net_if_ipv6_maddr_is_joined(struct net_if_mcast_addr *addr)
{
        NET_ASSERT(addr);
 
        return addr->is_joined;
}
 
void net_if_ipv6_maddr_leave(struct net_if_mcast_addr *addr);
 
struct net_if_ipv6_prefix *net_if_ipv6_prefix_get(struct net_if *iface,
                                                  struct in6_addr *addr);
 
struct net_if_ipv6_prefix *net_if_ipv6_prefix_lookup(struct net_if *iface,
                                                     struct in6_addr *addr,
                                                     uint8_t len);
 
struct net_if_ipv6_prefix *net_if_ipv6_prefix_add(struct net_if *iface,
                                                  struct in6_addr *prefix,
                                                  uint8_t len,
                                                  uint32_t lifetime);
 
bool net_if_ipv6_prefix_rm(struct net_if *iface, struct in6_addr *addr,
                           uint8_t len);
 
static inline void net_if_ipv6_prefix_set_lf(struct net_if_ipv6_prefix *prefix,
                                             bool is_infinite)
{
        prefix->is_infinite = is_infinite;
}
 
void net_if_ipv6_prefix_set_timer(struct net_if_ipv6_prefix *prefix,
                                  uint32_t lifetime);
 
void net_if_ipv6_prefix_unset_timer(struct net_if_ipv6_prefix *prefix);
 
bool net_if_ipv6_addr_onlink(struct net_if **iface, struct in6_addr *addr);
 
#if defined(CONFIG_NET_NATIVE_IPV6)
static inline struct in6_addr *net_if_router_ipv6(struct net_if_router *router)
{
        return &router->address.in6_addr;
}
#else
static inline struct in6_addr *net_if_router_ipv6(struct net_if_router *router)
{
        static struct in6_addr addr;
 
        ARG_UNUSED(router);
 
        return &addr;
}
#endif
 
struct net_if_router *net_if_ipv6_router_lookup(struct net_if *iface,
                                                struct in6_addr *addr);
 
struct net_if_router *net_if_ipv6_router_find_default(struct net_if *iface,
                                                      struct in6_addr *addr);
 
void net_if_ipv6_router_update_lifetime(struct net_if_router *router,
                                        uint16_t lifetime);
 
struct net_if_router *net_if_ipv6_router_add(struct net_if *iface,
                                             struct in6_addr *addr,
                                             uint16_t router_lifetime);
 
bool net_if_ipv6_router_rm(struct net_if_router *router);
 
uint8_t net_if_ipv6_get_hop_limit(struct net_if *iface);
 
void net_ipv6_set_hop_limit(struct net_if *iface, uint8_t hop_limit);
 
static inline void net_if_ipv6_set_base_reachable_time(struct net_if *iface,
                                                       uint32_t reachable_time)
{
#if defined(CONFIG_NET_NATIVE_IPV6)
        if (!iface->config.ip.ipv6) {
                return;
        }
 
        iface->config.ip.ipv6->base_reachable_time = reachable_time;
#endif
}
 
static inline uint32_t net_if_ipv6_get_reachable_time(struct net_if *iface)
{
#if defined(CONFIG_NET_NATIVE_IPV6)
        if (!iface->config.ip.ipv6) {
                return 0;
        }
 
        return iface->config.ip.ipv6->reachable_time;
#else
        return 0;
#endif
}
 
uint32_t net_if_ipv6_calc_reachable_time(struct net_if_ipv6 *ipv6);
 
static inline void net_if_ipv6_set_reachable_time(struct net_if_ipv6 *ipv6)
{
#if defined(CONFIG_NET_NATIVE_IPV6)
        ipv6->reachable_time = net_if_ipv6_calc_reachable_time(ipv6);
#endif
}
 
static inline void net_if_ipv6_set_retrans_timer(struct net_if *iface,
                                                 uint32_t retrans_timer)
{
#if defined(CONFIG_NET_NATIVE_IPV6)
        if (!iface->config.ip.ipv6) {
                return;
        }
 
        iface->config.ip.ipv6->retrans_timer = retrans_timer;
#endif
}
 
static inline uint32_t net_if_ipv6_get_retrans_timer(struct net_if *iface)
{
#if defined(CONFIG_NET_NATIVE_IPV6)
        if (!iface->config.ip.ipv6) {
                return 0;
        }
 
        return iface->config.ip.ipv6->retrans_timer;
#else
        return 0;
#endif
}
 
#if defined(CONFIG_NET_NATIVE_IPV6)
const struct in6_addr *net_if_ipv6_select_src_addr(struct net_if *iface,
                                                   const struct in6_addr *dst);
#else
static inline const struct in6_addr *net_if_ipv6_select_src_addr(
        struct net_if *iface, const struct in6_addr *dst)
{
        ARG_UNUSED(iface);
        ARG_UNUSED(dst);
 
        return NULL;
}
#endif
 
#if defined(CONFIG_NET_NATIVE_IPV6)
struct net_if *net_if_ipv6_select_src_iface(const struct in6_addr *dst);
#else
static inline struct net_if *net_if_ipv6_select_src_iface(
        const struct in6_addr *dst)
{
        ARG_UNUSED(dst);
 
        return NULL;
}
#endif
 
struct in6_addr *net_if_ipv6_get_ll(struct net_if *iface,
                                    enum net_addr_state addr_state);
 
struct in6_addr *net_if_ipv6_get_ll_addr(enum net_addr_state state,
                                         struct net_if **iface);
 
void net_if_ipv6_dad_failed(struct net_if *iface, const struct in6_addr *addr);
 
struct in6_addr *net_if_ipv6_get_global_addr(enum net_addr_state state,
                                             struct net_if **iface);
 
int net_if_config_ipv4_get(struct net_if *iface,
                           struct net_if_ipv4 **ipv4);
 
int net_if_config_ipv4_put(struct net_if *iface);
 
uint8_t net_if_ipv4_get_ttl(struct net_if *iface);
 
void net_if_ipv4_set_ttl(struct net_if *iface, uint8_t ttl);
 
struct net_if_addr *net_if_ipv4_addr_lookup(const struct in_addr *addr,
                                            struct net_if **iface);
 
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);
 
bool net_if_ipv4_addr_rm(struct net_if *iface, const struct in_addr *addr);
 
__syscall int net_if_ipv4_addr_lookup_by_index(const struct in_addr *addr);
 
__syscall bool net_if_ipv4_addr_add_by_index(int index,
                                             struct in_addr *addr,
                                             enum net_addr_type addr_type,
                                             uint32_t vlifetime);
 
__syscall bool net_if_ipv4_addr_rm_by_index(int index,
                                            const struct in_addr *addr);
 
struct net_if_mcast_addr *net_if_ipv4_maddr_add(struct net_if *iface,
                                                const struct in_addr *addr);
 
bool net_if_ipv4_maddr_rm(struct net_if *iface, const struct in_addr *addr);
 
struct net_if_mcast_addr *net_if_ipv4_maddr_lookup(const struct in_addr *addr,
                                                   struct net_if **iface);
 
void net_if_ipv4_maddr_join(struct net_if_mcast_addr *addr);
 
static inline bool net_if_ipv4_maddr_is_joined(struct net_if_mcast_addr *addr)
{
        NET_ASSERT(addr);
 
        return addr->is_joined;
}
 
void net_if_ipv4_maddr_leave(struct net_if_mcast_addr *addr);
 
#if defined(CONFIG_NET_NATIVE_IPV4)
static inline struct in_addr *net_if_router_ipv4(struct net_if_router *router)
{
        return &router->address.in_addr;
}
#else
static inline struct in_addr *net_if_router_ipv4(struct net_if_router *router)
{
        static struct in_addr addr;
 
        ARG_UNUSED(router);
 
        return &addr;
}
#endif
 
struct net_if_router *net_if_ipv4_router_lookup(struct net_if *iface,
                                                struct in_addr *addr);
 
struct net_if_router *net_if_ipv4_router_find_default(struct net_if *iface,
                                                      struct in_addr *addr);
struct net_if_router *net_if_ipv4_router_add(struct net_if *iface,
                                             struct in_addr *addr,
                                             bool is_default,
                                             uint16_t router_lifetime);
 
bool net_if_ipv4_router_rm(struct net_if_router *router);
 
bool net_if_ipv4_addr_mask_cmp(struct net_if *iface,
                               const struct in_addr *addr);
 
bool net_if_ipv4_is_addr_bcast(struct net_if *iface,
                               const struct in_addr *addr);
 
#if defined(CONFIG_NET_NATIVE_IPV4)
struct net_if *net_if_ipv4_select_src_iface(const struct in_addr *dst);
#else
static inline struct net_if *net_if_ipv4_select_src_iface(
        const struct in_addr *dst)
{
        ARG_UNUSED(dst);
 
        return NULL;
}
#endif
 
#if defined(CONFIG_NET_NATIVE_IPV4)
const struct in_addr *net_if_ipv4_select_src_addr(struct net_if *iface,
                                                  const struct in_addr *dst);
#else
static inline const struct in_addr *net_if_ipv4_select_src_addr(
        struct net_if *iface, const struct in_addr *dst)
{
        ARG_UNUSED(iface);
        ARG_UNUSED(dst);
 
        return NULL;
}
#endif
 
struct in_addr *net_if_ipv4_get_ll(struct net_if *iface,
                                   enum net_addr_state addr_state);
 
struct in_addr *net_if_ipv4_get_global_addr(struct net_if *iface,
                                            enum net_addr_state addr_state);
 
void net_if_ipv4_set_netmask(struct net_if *iface,
                             const struct in_addr *netmask);
 
__syscall bool net_if_ipv4_set_netmask_by_index(int index,
                                                const struct in_addr *netmask);
 
void net_if_ipv4_set_gw(struct net_if *iface, const struct in_addr *gw);
 
__syscall bool net_if_ipv4_set_gw_by_index(int index, const struct in_addr *gw);
 
struct net_if *net_if_select_src_iface(const struct sockaddr *dst);
 
typedef void (*net_if_link_callback_t)(struct net_if *iface,
                                       struct net_linkaddr *dst,
                                       int status);
 
struct net_if_link_cb {
        sys_snode_t node;
 
        net_if_link_callback_t cb;
};
 
void net_if_register_link_cb(struct net_if_link_cb *link,
                             net_if_link_callback_t cb);
 
void net_if_unregister_link_cb(struct net_if_link_cb *link);
 
void net_if_call_link_cb(struct net_if *iface, struct net_linkaddr *lladdr,
                         int status);
 
bool net_if_need_calc_rx_checksum(struct net_if *iface);
 
bool net_if_need_calc_tx_checksum(struct net_if *iface);
 
__syscall struct net_if *net_if_get_by_index(int index);
 
int net_if_get_by_iface(struct net_if *iface);
 
typedef void (*net_if_cb_t)(struct net_if *iface, void *user_data);
 
void net_if_foreach(net_if_cb_t cb, void *user_data);
 
int net_if_up(struct net_if *iface);
 
static inline bool net_if_is_up(struct net_if *iface)
{
        NET_ASSERT(iface);
 
        return net_if_flag_is_set(iface, NET_IF_UP);
}
 
int net_if_down(struct net_if *iface);
 
#if defined(CONFIG_NET_PKT_TIMESTAMP) && defined(CONFIG_NET_NATIVE)
typedef void (*net_if_timestamp_callback_t)(struct net_pkt *pkt);
 
struct net_if_timestamp_cb {
        sys_snode_t node;
 
        struct net_pkt *pkt;
 
        struct net_if *iface;
 
        net_if_timestamp_callback_t cb;
};
 
void net_if_register_timestamp_cb(struct net_if_timestamp_cb *handle,
                                  struct net_pkt *pkt,
                                  struct net_if *iface,
                                  net_if_timestamp_callback_t cb);
 
void net_if_unregister_timestamp_cb(struct net_if_timestamp_cb *handle);
 
void net_if_call_timestamp_cb(struct net_pkt *pkt);
 
/*
 * @brief Add timestamped TX buffer to be handled
 *
 * @param pkt Timestamped buffer
 */
void net_if_add_tx_timestamp(struct net_pkt *pkt);
#endif /* CONFIG_NET_PKT_TIMESTAMP */
 
int net_if_set_promisc(struct net_if *iface);
 
void net_if_unset_promisc(struct net_if *iface);
 
bool net_if_is_promisc(struct net_if *iface);
 
static inline bool net_if_are_pending_tx_packets(struct net_if *iface)
{
#if defined(CONFIG_NET_POWER_MANAGEMENT)
        return !!iface->tx_pending;
#else
        ARG_UNUSED(iface);
 
        return false;
#endif
}
 
#ifdef CONFIG_NET_POWER_MANAGEMENT
int net_if_suspend(struct net_if *iface);
 
int net_if_resume(struct net_if *iface);
 
bool net_if_is_suspended(struct net_if *iface);
#endif /* CONFIG_NET_POWER_MANAGEMENT */
 
struct net_if_api {
        void (*init)(struct net_if *iface);
};
 
#if defined(CONFIG_NET_IP)
#define NET_IF_IP_INIT .ip = {},
#else
#define NET_IF_IP_INIT
#endif
 
#if defined(CONFIG_NET_DHCPV4) && defined(CONFIG_NET_NATIVE_IPV4)
#define NET_IF_DHCPV4_INIT .dhcpv4.state = NET_DHCPV4_DISABLED,
#else
#define NET_IF_DHCPV4_INIT
#endif
 
#define NET_IF_CONFIG_INIT                              \
        .config = {                                     \
                NET_IF_IP_INIT                          \
                NET_IF_DHCPV4_INIT                      \
        }
 
#define NET_IF_GET_NAME(dev_name, sfx) __net_if_##dev_name##_##sfx
#define NET_IF_DEV_GET_NAME(dev_name, sfx) __net_if_dev_##dev_name##_##sfx
 
#define NET_IF_GET(dev_name, sfx)                                       \
        ((struct net_if *)&NET_IF_GET_NAME(dev_name, sfx))
 
#define NET_IF_INIT(dev_name, sfx, _l2, _mtu, _num_configs)             \
        static STRUCT_SECTION_ITERABLE(net_if_dev,                      \
                                NET_IF_DEV_GET_NAME(dev_name, sfx)) = { \
                .dev = &(DEVICE_NAME_GET(dev_name)),                    \
                .l2 = &(NET_L2_GET_NAME(_l2)),                          \
                .l2_data = &(NET_L2_GET_DATA(dev_name, sfx)),           \
                .mtu = _mtu,                                            \
        };                                                              \
        static Z_DECL_ALIGN(struct net_if)                              \
                       NET_IF_GET_NAME(dev_name, sfx)[_num_configs]     \
                       __used __in_section(_net_if, static,             \
                                           dev_name) = {                \
                [0 ... (_num_configs - 1)] = {                          \
                        .if_dev = &(NET_IF_DEV_GET_NAME(dev_name, sfx)), \
                        NET_IF_CONFIG_INIT                              \
                }                                                       \
        }
 
#define NET_IF_OFFLOAD_INIT(dev_name, sfx, _mtu)                        \
        static STRUCT_SECTION_ITERABLE(net_if_dev,                      \
                                NET_IF_DEV_GET_NAME(dev_name, sfx)) = { \
                .dev = &(DEVICE_NAME_GET(dev_name)),                    \
                .mtu = _mtu,                                            \
        };                                                              \
        static Z_DECL_ALIGN(struct net_if)                              \
                NET_IF_GET_NAME(dev_name, sfx)[NET_IF_MAX_CONFIGS]      \
                       __used __in_section(_net_if, static,             \
                                           dev_name) = {                \
                [0 ... (NET_IF_MAX_CONFIGS - 1)] = {                    \
                        .if_dev = &(NET_IF_DEV_GET_NAME(dev_name, sfx)), \
                        NET_IF_CONFIG_INIT                              \
                }                                                       \
        }
 
/* Network device initialization macros */
 
#define Z_NET_DEVICE_INIT(node_id, dev_name, drv_name, init_fn,         \
                        pm_action_cb, data, cfg, prio, api, l2, \
                        l2_ctx_type, mtu)                               \
        Z_DEVICE_STATE_DEFINE(node_id, dev_name)                        \
        Z_DEVICE_DEFINE(node_id, dev_name, drv_name, init_fn,           \
                        pm_action_cb, data,                             \
                        cfg, POST_KERNEL, prio, api,                    \
                        &Z_DEVICE_STATE_NAME(dev_name));                \
        NET_L2_DATA_INIT(dev_name, 0, l2_ctx_type);                     \
        NET_IF_INIT(dev_name, 0, l2, mtu, NET_IF_MAX_CONFIGS)
 
#define NET_DEVICE_INIT(dev_name, drv_name, init_fn, pm_action_cb,      \
                        data, cfg, prio, api, l2,                       \
                        l2_ctx_type, mtu)                               \
        Z_NET_DEVICE_INIT(DT_INVALID_NODE, dev_name, drv_name, init_fn, \
                        pm_action_cb, data, cfg, prio, api, l2, \
                        l2_ctx_type, mtu)
 
#define NET_DEVICE_DT_DEFINE(node_id, init_fn, pm_action_cb, data, cfg, \
                           prio, api, l2, l2_ctx_type, mtu)             \
        Z_NET_DEVICE_INIT(node_id, Z_DEVICE_DT_DEV_NAME(node_id),       \
                          DEVICE_DT_NAME(node_id), init_fn,             \
                          pm_action_cb, data, cfg, prio, api, l2,       \
                          l2_ctx_type, mtu)
 
#define NET_DEVICE_DT_INST_DEFINE(inst, ...) \
        NET_DEVICE_DT_DEFINE(DT_DRV_INST(inst), __VA_ARGS__)
 
#define Z_NET_DEVICE_INIT_INSTANCE(node_id, dev_name, drv_name,         \
                                   instance, init_fn, pm_action_cb,     \
                                   data, cfg, prio, api, l2,            \
                                   l2_ctx_type, mtu)                    \
        Z_DEVICE_STATE_DEFINE(node_id, dev_name)                        \
        Z_DEVICE_DEFINE(node_id, dev_name, drv_name, init_fn,           \
                        pm_action_cb, data, cfg, POST_KERNEL,           \
                        prio, api, &Z_DEVICE_STATE_NAME(dev_name));     \
        NET_L2_DATA_INIT(dev_name, instance, l2_ctx_type);              \
        NET_IF_INIT(dev_name, instance, l2, mtu, NET_IF_MAX_CONFIGS)
 
#define NET_DEVICE_INIT_INSTANCE(dev_name, drv_name, instance, init_fn, \
                                 pm_action_cb, data, cfg, prio, \
                                 api, l2, l2_ctx_type, mtu)             \
        Z_NET_DEVICE_INIT_INSTANCE(DT_INVALID_NODE, dev_name, drv_name, \
                                   instance, init_fn, pm_action_cb,     \
                                   data, cfg, prio, api, l2,            \
                                   l2_ctx_type, mtu)
 
#define NET_DEVICE_DT_DEFINE_INSTANCE(node_id, instance, init_fn,       \
                                      pm_action_cb, data, cfg, prio,    \
                                      api, l2, l2_ctx_type, mtu)        \
        Z_NET_DEVICE_INIT_INSTANCE(node_id,                             \
                                   Z_DEVICE_DT_DEV_NAME(node_id),       \
                                   DEVICE_DT_NAME(node_id),             \
                                   instance, init_fn,                   \
                                   pm_action_cb, data, cfg, prio, api,  \
                                   l2, l2_ctx_type, mtu)
 
#define NET_DEVICE_DT_INST_DEFINE_INSTANCE(inst, ...) \
        NET_DEVICE_DT_DEFINE_INSTANCE(DT_DRV_INST(inst), __VA_ARGS__)
 
#define Z_NET_DEVICE_OFFLOAD_INIT(node_id, dev_name, drv_name, init_fn, \
                                  pm_action_cb, data, cfg, prio,        \
                                  api, mtu)                             \
        Z_DEVICE_STATE_DEFINE(node_id, dev_name)                        \
        Z_DEVICE_DEFINE(node_id, dev_name, drv_name, init_fn,           \
                pm_action_cb, data, cfg, POST_KERNEL, prio, api,        \
                &Z_DEVICE_STATE_NAME(dev_name));                        \
        NET_IF_OFFLOAD_INIT(dev_name, 0, mtu)
 
#define NET_DEVICE_OFFLOAD_INIT(dev_name, drv_name, init_fn,            \
                                pm_action_cb, data, cfg, prio, api, mtu)\
        Z_NET_DEVICE_OFFLOAD_INIT(DT_INVALID_NODE, dev_name, drv_name,  \
                                init_fn, pm_action_cb, data, cfg, prio,\
                                api, mtu)
 
#define NET_DEVICE_DT_OFFLOAD_DEFINE(node_id, init_fn, pm_action_cb,    \
                                   data, cfg, prio, api, mtu)           \
        Z_NET_DEVICE_OFFLOAD_INIT(node_id, Z_DEVICE_DT_DEV_NAME(node_id), \
                                  DEVICE_DT_NAME(node_id),              \
                                  init_fn, pm_action_cb, data, cfg,     \
                                  prio, api, mtu)
 
#define NET_DEVICE_DT_INST_OFFLOAD_DEFINE(inst, ...) \
        NET_DEVICE_DT_OFFLOAD_DEFINE(DT_DRV_INST(inst), __VA_ARGS__)
 
#ifdef __cplusplus
}
#endif
 
#include <syscalls/net_if.h>
 
#endif /* ZEPHYR_INCLUDE_NET_NET_IF_H_ */