IPv4/IPv6 primitives and helpers . More...

Data Structures
struct	in6_addr
	IPv6 address struct. More...

struct	in_addr
	IPv4 address struct. More...

struct	sockaddr_in6
	Socket address struct for IPv6. More...

struct	sockaddr_in
	Socket address struct for IPv4. More...

struct	sockaddr_ll
	Socket address struct for packet socket. More...

struct	iovec
	IO vector array element. More...

struct	msghdr
	Message struct. More...

struct	cmsghdr
	Control message ancillary data. More...

struct	sockaddr
	Generic sockaddr struct. More...

struct	net_tuple
	IPv6/IPv4 network connection tuple. More...

Macros
#define	PF_UNSPEC 0
	Unspecified protocol family.

#define	PF_INET 1
	IP protocol family version 4.

#define	PF_INET6 2
	IP protocol family version 6.

#define	PF_PACKET 3
	Packet family.

#define	PF_CAN 4
	Controller Area Network.

#define	PF_NET_MGMT 5
	Network management info.

#define	PF_LOCAL 6
	Inter-process communication

#define	PF_UNIX PF_LOCAL
	Inter-process communication

#define	AF_UNSPEC PF_UNSPEC
	Unspecified address family.

#define	AF_INET PF_INET
	IP protocol family version 4.

#define	AF_INET6 PF_INET6
	IP protocol family version 6.

#define	AF_PACKET PF_PACKET
	Packet family.

#define	AF_CAN PF_CAN
	Controller Area Network.

#define	AF_NET_MGMT PF_NET_MGMT
	Network management info.

#define	AF_LOCAL PF_LOCAL
	Inter-process communication

#define	AF_UNIX PF_UNIX
	Inter-process communication

#define	ntohs(x)
	Convert 16-bit value from network to host byte order.

#define	ntohl(x)
	Convert 32-bit value from network to host byte order.

#define	ntohll(x)
	Convert 64-bit value from network to host byte order.

#define	htons(x)
	Convert 16-bit value from host to network byte order.

#define	htonl(x)
	Convert 32-bit value from host to network byte order.

#define	htonll(x)
	Convert 64-bit value from host to network byte order.

#define	NET_IPV6_ADDR_SIZE 16
	Binary size of the IPv6 address.

#define	NET_IPV4_ADDR_SIZE 4
	Binary size of the IPv4 address.

#define	CMSG_FIRSTHDR(msghdr)
	Returns a pointer to the first cmsghdr in the ancillary data buffer associated with the passed msghdr.

#define	CMSG_NXTHDR(msghdr, cmsg)
	Returns the next valid cmsghdr after the passed cmsghdr.

#define	CMSG_DATA(cmsg)
	Returns a pointer to the data portion of a cmsghdr.

#define	CMSG_SPACE(length)
	Returns the number of bytes an ancillary element with payload of the passed data length occupies.

#define	CMSG_LEN(length)
	Returns the value to store in the cmsg_len member of the cmsghdr structure, taking into account any necessary alignment.

#define	IN6ADDR_ANY_INIT
	IPv6 address initializer.

#define	IN6ADDR_LOOPBACK_INIT
	IPv6 loopback address initializer.

#define	INADDR_ANY 0
	IPv4 any address.

#define	INADDR_BROADCAST 0xffffffff
	IPv4 broadcast address.

#define	INADDR_ANY_INIT { { { INADDR_ANY } } }
	IPv4 address initializer.

#define	INADDR_LOOPBACK_INIT { { { 127, 0, 0, 1 } } }
	IPv6 loopback address initializer.

#define	INET_ADDRSTRLEN 16
	Max length of the IPv4 address as a string.

#define	INET6_ADDRSTRLEN 46
	Max length of the IPv6 address as a string.

#define	NET_MAX_PRIORITIES 8
	How many priority values there are.

#define	net_ipaddr_copy(dest, src)
	Copy an IPv4 or IPv6 address.

Typedefs
typedef unsigned short int	sa_family_t
	Socket address family type.

typedef size_t	socklen_t
	Length of a socket address.

Enumerations
enum	net_ip_protocol { IPPROTO_IP = 0 , IPPROTO_ICMP = 1 , IPPROTO_IGMP = 2 , IPPROTO_ETH_P_ALL = 3 , IPPROTO_IPIP = 4 , IPPROTO_TCP = 6 , IPPROTO_UDP = 17 , IPPROTO_IPV6 = 41 , IPPROTO_ICMPV6 = 58 , IPPROTO_RAW = 255 }
	Protocol numbers from IANA/BSD. More...

enum	net_ip_protocol_secure { IPPROTO_TLS_1_0 = 256 , IPPROTO_TLS_1_1 = 257 , IPPROTO_TLS_1_2 = 258 , IPPROTO_TLS_1_3 = 259 , IPPROTO_DTLS_1_0 = 272 , IPPROTO_DTLS_1_2 = 273 }
	Protocol numbers for TLS protocols. More...

enum	net_sock_type { SOCK_STREAM = 1 , SOCK_DGRAM , SOCK_RAW }
	Socket type. More...

enum	net_ip_mtu { NET_IPV6_MTU = 1280 , NET_IPV4_MTU = 576 }
	IP Maximum Transfer Unit. More...

enum	net_priority { NET_PRIORITY_BK = 1 , NET_PRIORITY_BE = 0 , NET_PRIORITY_EE = 2 , NET_PRIORITY_CA = 3 , NET_PRIORITY_VI = 4 , NET_PRIORITY_VO = 5 , NET_PRIORITY_IC = 6 , NET_PRIORITY_NC = 7 }
	Network packet priority settings described in IEEE 802.1Q Annex I.1. More...

enum	net_addr_state { NET_ADDR_ANY_STATE = -1 , NET_ADDR_TENTATIVE = 0 , NET_ADDR_PREFERRED , NET_ADDR_DEPRECATED }
	What is the current state of the network address. More...

enum	net_addr_type { NET_ADDR_ANY = 0 , NET_ADDR_AUTOCONF , NET_ADDR_DHCP , NET_ADDR_MANUAL , NET_ADDR_OVERRIDABLE }
	How the network address is assigned to network interface. More...

Functions
static bool	net_ipv6_is_addr_loopback (struct in6_addr *addr)
	Check if the IPv6 address is a loopback address (::1).

static bool	net_ipv6_is_addr_mcast (const struct in6_addr *addr)
	Check if the IPv6 address is a multicast address.

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

static bool	net_ipv6_is_my_addr (struct in6_addr *addr)
	Check if IPv6 address is found in one of the network interfaces.

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

static bool	net_ipv6_is_my_maddr (struct in6_addr *maddr)
	Check if IPv6 multicast address is found in one of the network interfaces.

static bool	net_ipv6_is_prefix (const uint8_t addr1, const uint8_t addr2, uint8_t length)
	Check if two IPv6 addresses are same when compared after prefix mask.

static void	net_ipv6_addr_prefix_mask (const uint8_t inaddr, uint8_t outaddr, uint8_t prefix_len)
	Get the IPv6 network address via the unicast address and the prefix mask.

static bool	net_ipv4_is_addr_loopback (struct in_addr *addr)
	Check if the IPv4 address is a loopback address (127.0.0.0/8).

static bool	net_ipv4_is_addr_unspecified (const struct in_addr *addr)
	Check if the IPv4 address is unspecified (all bits zero)

static bool	net_ipv4_is_addr_mcast (const struct in_addr *addr)
	Check if the IPv4 address is a multicast address.

static bool	net_ipv4_is_ll_addr (const struct in_addr *addr)
	Check if the given IPv4 address is a link local address.

static bool	net_ipv4_is_private_addr (const struct in_addr *addr)
	Check if the given IPv4 address is from a private address range.

static void	net_ipv4_addr_copy_raw (uint8_t dest, const uint8_t src)
	Copy an IPv4 address raw buffer.

static void	net_ipv6_addr_copy_raw (uint8_t dest, const uint8_t src)
	Copy an IPv6 address raw buffer.

static bool	net_ipv4_addr_cmp (const struct in_addr addr1, const struct in_addr addr2)
	Compare two IPv4 addresses.

static bool	net_ipv4_addr_cmp_raw (const uint8_t addr1, const uint8_t addr2)
	Compare two raw IPv4 address buffers.

static bool	net_ipv6_addr_cmp (const struct in6_addr addr1, const struct in6_addr addr2)
	Compare two IPv6 addresses.

static bool	net_ipv6_addr_cmp_raw (const uint8_t addr1, const uint8_t addr2)
	Compare two raw IPv6 address buffers.

static bool	net_ipv6_is_ll_addr (const struct in6_addr *addr)
	Check if the given IPv6 address is a link local address.

static bool	net_ipv6_is_sl_addr (const struct in6_addr *addr)
	Check if the given IPv6 address is a site local address.

static bool	net_ipv6_is_ula_addr (const struct in6_addr *addr)
	Check if the given IPv6 address is a unique local address.

static bool	net_ipv6_is_global_addr (const struct in6_addr *addr)
	Check if the given IPv6 address is a global address.

static bool	net_ipv6_is_private_addr (const struct in6_addr *addr)
	Check if the given IPv6 address is from a private/local address range.

const struct in6_addr *	net_ipv6_unspecified_address (void)
	Return pointer to any (all bits zeros) IPv6 address.

const struct in_addr *	net_ipv4_unspecified_address (void)
	Return pointer to any (all bits zeros) IPv4 address.

const struct in_addr *	net_ipv4_broadcast_address (void)
	Return pointer to broadcast (all bits ones) IPv4 address.

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

static bool	net_ipv4_addr_mask_cmp (struct net_if iface, const struct in_addr addr)
	Check if the given address belongs to same subnet that has been configured for the interface.

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

static bool	net_ipv4_is_addr_bcast (struct net_if iface, const struct in_addr addr)
	Check if the given IPv4 address is a broadcast address.

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

static bool	net_ipv4_is_my_addr (const struct in_addr *addr)
	Check if the IPv4 address is assigned to any network interface in the system.

static bool	net_ipv6_is_addr_unspecified (const struct in6_addr *addr)
	Check if the IPv6 address is unspecified (all bits zero)

static bool	net_ipv6_is_addr_solicited_node (const struct in6_addr *addr)
	Check if the IPv6 address is solicited node multicast address FF02:0:0:0:0:1:FFXX:XXXX defined in RFC 3513.

static bool	net_ipv6_is_addr_mcast_scope (const struct in6_addr *addr, int scope)
	Check if the IPv6 address is a given scope multicast address (FFyx::).

static bool	net_ipv6_is_same_mcast_scope (const struct in6_addr addr_1, const struct in6_addr addr_2)
	Check if the IPv6 addresses have the same multicast scope (FFyx::).

static bool	net_ipv6_is_addr_mcast_global (const struct in6_addr *addr)
	Check if the IPv6 address is a global multicast address (FFxE::/16).

static bool	net_ipv6_is_addr_mcast_iface (const struct in6_addr *addr)
	Check if the IPv6 address is a interface scope multicast address (FFx1::).

static bool	net_ipv6_is_addr_mcast_link (const struct in6_addr *addr)
	Check if the IPv6 address is a link local scope multicast address (FFx2::).

static bool	net_ipv6_is_addr_mcast_mesh (const struct in6_addr *addr)
	Check if the IPv6 address is a mesh-local scope multicast address (FFx3::).

static bool	net_ipv6_is_addr_mcast_site (const struct in6_addr *addr)
	Check if the IPv6 address is a site scope multicast address (FFx5::).

static bool	net_ipv6_is_addr_mcast_org (const struct in6_addr *addr)
	Check if the IPv6 address is an organization scope multicast address (FFx8::).

static bool	net_ipv6_is_addr_mcast_group (const struct in6_addr addr, const struct in6_addr group)
	Check if the IPv6 address belongs to certain multicast group.

static bool	net_ipv6_is_addr_mcast_all_nodes_group (const struct in6_addr *addr)
	Check if the IPv6 address belongs to the all nodes multicast group.

static bool	net_ipv6_is_addr_mcast_iface_all_nodes (const struct in6_addr *addr)
	Check if the IPv6 address is a interface scope all nodes multicast address (FF01::1).

static bool	net_ipv6_is_addr_mcast_link_all_nodes (const struct in6_addr *addr)
	Check if the IPv6 address is a link local scope all nodes multicast address (FF02::1).

static void	net_ipv6_addr_create_solicited_node (const struct in6_addr src, struct in6_addr dst)
	Create solicited node IPv6 multicast address FF02:0:0:0:0:1:FFXX:XXXX defined in RFC 3513.

static void	net_ipv6_addr_create (struct in6_addr *addr, uint16_t addr0, uint16_t addr1, uint16_t addr2, uint16_t addr3, uint16_t addr4, uint16_t addr5, uint16_t addr6, uint16_t addr7)
	Construct an IPv6 address from eight 16-bit words.

static void	net_ipv6_addr_create_ll_allnodes_mcast (struct in6_addr *addr)
	Create link local allnodes multicast IPv6 address.

static void	net_ipv6_addr_create_ll_allrouters_mcast (struct in6_addr *addr)
	Create link local allrouters multicast IPv6 address.

static void	net_ipv6_addr_create_v4_mapped (const struct in_addr addr4, struct in6_addr addr6)
	Create IPv4 mapped IPv6 address.

static bool	net_ipv6_addr_is_v4_mapped (const struct in6_addr *addr)
	Is the IPv6 address an IPv4 mapped one.

int	net_ipv6_addr_generate_iid (struct net_if iface, const struct in6_addr prefix, uint8_t network_id, size_t network_id_len, uint8_t dad_counter, struct in6_addr addr, struct net_linkaddr *lladdr)
	Generate IPv6 address using a prefix and interface identifier.

static void	net_ipv6_addr_create_iid (struct in6_addr addr, struct net_linkaddr lladdr)
	Create IPv6 address interface identifier.

static bool	net_ipv6_addr_based_on_ll (const struct in6_addr addr, const struct net_linkaddr lladdr)
	Check if given address is based on link layer address.

static struct sockaddr_in6 *	net_sin6 (const struct sockaddr *addr)
	Get sockaddr_in6 from sockaddr.

static struct sockaddr_in *	net_sin (const struct sockaddr *addr)
	Get sockaddr_in from sockaddr.

static struct sockaddr_in6_ptr *	net_sin6_ptr (const struct sockaddr_ptr *addr)
	Get sockaddr_in6_ptr from sockaddr_ptr.

static struct sockaddr_in_ptr *	net_sin_ptr (const struct sockaddr_ptr *addr)
	Get sockaddr_in_ptr from sockaddr_ptr.

static struct sockaddr_ll_ptr *	net_sll_ptr (const struct sockaddr_ptr *addr)
	Get sockaddr_ll_ptr from sockaddr_ptr.

static struct sockaddr_can_ptr *	net_can_ptr (const struct sockaddr_ptr *addr)
	Get sockaddr_can_ptr from sockaddr_ptr.

int	net_addr_pton (sa_family_t family, const char src, void dst)
	Convert a string to IP address.

char *	net_addr_ntop (sa_family_t family, const void src, char dst, size_t size)
	Convert IP address to string form.

bool	net_ipaddr_parse (const char str, size_t str_len, struct sockaddr addr)
	Parse a string that contains either IPv4 or IPv6 address and optional port, and store the information in user supplied sockaddr struct.

int	net_port_set_default (struct sockaddr *addr, uint16_t default_port)
	Set the default port in the sockaddr structure.

static int32_t	net_tcp_seq_cmp (uint32_t seq1, uint32_t seq2)
	Compare TCP sequence numbers.

static bool	net_tcp_seq_greater (uint32_t seq1, uint32_t seq2)
	Check that one TCP sequence number is greater.

int	net_bytes_from_str (uint8_t buf, int buf_len, const char src)
	Convert a string of hex values to array of bytes.

int	net_tx_priority2tc (enum net_priority prio)
	Convert Tx network packet priority to traffic class so we can place the packet into correct Tx queue.

int	net_rx_priority2tc (enum net_priority prio)
	Convert Rx network packet priority to traffic class so we can place the packet into correct Rx queue.

static enum net_priority	net_vlan2priority (uint8_t priority)
	Convert network packet VLAN priority to network packet priority so we can place the packet into correct queue.

static uint8_t	net_priority2vlan (enum net_priority priority)
	Convert network packet priority to network packet VLAN priority.

const char *	net_family2str (sa_family_t family)
	Return network address family value as a string.

static int	net_ipv6_pe_add_filter (struct in6_addr *addr, bool is_denylist)
	Add IPv6 prefix as a privacy extension filter.

static int	net_ipv6_pe_del_filter (struct in6_addr *addr)
	Delete IPv6 prefix from privacy extension filter list.

Detailed Description

IPv4/IPv6 primitives and helpers .

Since: 1.0

Version: 1.0.0

Macro Definition Documentation

◆ AF_CAN

#define AF_CAN PF_CAN

#include <zephyr/net/net_ip.h>

Controller Area Network.

◆ AF_INET

#define AF_INET PF_INET

#include <zephyr/net/net_ip.h>

IP protocol family version 4.

◆ AF_INET6

#define AF_INET6 PF_INET6

#include <zephyr/net/net_ip.h>

IP protocol family version 6.

◆ AF_LOCAL

#define AF_LOCAL PF_LOCAL

#include <zephyr/net/net_ip.h>

Inter-process communication

◆ AF_NET_MGMT

#define AF_NET_MGMT PF_NET_MGMT

#include <zephyr/net/net_ip.h>

Network management info.

◆ AF_PACKET

#define AF_PACKET PF_PACKET

#include <zephyr/net/net_ip.h>

Packet family.

◆ AF_UNIX

#define AF_UNIX PF_UNIX

#include <zephyr/net/net_ip.h>

Inter-process communication

◆ AF_UNSPEC

#define AF_UNSPEC PF_UNSPEC

#include <zephyr/net/net_ip.h>

Unspecified address family.

◆ CMSG_DATA

#define CMSG_DATA ( cmsg )

#include <zephyr/net/net_ip.h>

Value:

((uint8_t *)(cmsg) + ALIGN_D(sizeof(struct cmsghdr)))

uint8_t

__UINT8_TYPE__ uint8_t

Definition stdint.h:88

cmsghdr

Control message ancillary data.

Definition net_ip.h:268

Returns a pointer to the data portion of a cmsghdr.

The pointer returned cannot be assumed to be suitably aligned for accessing arbitrary payload data types. Applications should not cast it to a pointer type matching the payload, but should instead use memcpy(3) to copy data to or from a suitably declared object.

◆ CMSG_FIRSTHDR

#define CMSG_FIRSTHDR ( msghdr )

#include <zephyr/net/net_ip.h>

Value:

((msghdr)->msg_controllen >= sizeof(struct cmsghdr) ? \

(struct cmsghdr *)((msghdr)->msg_control) : NULL)

msghdr

Message struct.

Definition net_ip.h:257

Returns a pointer to the first cmsghdr in the ancillary data buffer associated with the passed msghdr.

It returns NULL if there isn't enough space for a cmsghdr in the buffer.

◆ CMSG_LEN

#define CMSG_LEN ( length )

#include <zephyr/net/net_ip.h>

Value:

(ALIGN_D(sizeof(struct cmsghdr)) + length)

Returns the value to store in the cmsg_len member of the cmsghdr structure, taking into account any necessary alignment.

It takes the data length as an argument.

◆ CMSG_NXTHDR

#define CMSG_NXTHDR	(		msghdr,
			cmsg )

#include <zephyr/net/net_ip.h>

Value:

        (((cmsg) == NULL) ? CMSG_FIRSTHDR(msghdr) :                      \
         (((uint8_t *)(cmsg) + ALIGN_H((cmsg)->cmsg_len) +               \
           ALIGN_D(sizeof(struct cmsghdr)) >                             \
           (uint8_t *)((msghdr)->msg_control) + (msghdr)->msg_controllen) ? \
          NULL :                                                         \
          (struct cmsghdr *)((uint8_t *)(cmsg) +                         \
                             ALIGN_H((cmsg)->cmsg_len))))

Returns the next valid cmsghdr after the passed cmsghdr.

It returns NULL when there isn't enough space left in the buffer.

◆ CMSG_SPACE

#define CMSG_SPACE ( length )

#include <zephyr/net/net_ip.h>

Value:

(ALIGN_D(sizeof(struct cmsghdr)) + ALIGN_H(length))

Returns the number of bytes an ancillary element with payload of the passed data length occupies.

◆ htonl

#define htonl ( x )

#include <zephyr/net/net_ip.h>

Value:

sys_cpu_to_be32(x)

sys_cpu_to_be32

#define sys_cpu_to_be32(val)

Convert 32-bit integer from host endianness to big-endian.

Definition byteorder.h:282

Convert 32-bit value from host to network byte order.

Parameters

x	The host byte order value to convert.

Returns: Network byte order value.

◆ htonll

#define htonll ( x )

#include <zephyr/net/net_ip.h>

Value:

sys_cpu_to_be64(x)

sys_cpu_to_be64

#define sys_cpu_to_be64(val)

Definition byteorder.h:288

Convert 64-bit value from host to network byte order.

Parameters

x	The host byte order value to convert.

Returns: Network byte order value.

◆ htons

#define htons ( x )

#include <zephyr/net/net_ip.h>

Value:

sys_cpu_to_be16(x)

sys_cpu_to_be16

#define sys_cpu_to_be16(val)

Convert 16-bit integer from host endianness to big-endian.

Definition byteorder.h:278

Convert 16-bit value from host to network byte order.

Parameters

x	The host byte order value to convert.

Returns: Network byte order value.

◆ IN6ADDR_ANY_INIT

#define IN6ADDR_ANY_INIT

#include <zephyr/net/net_ip.h>

Value:

{ { { 0, 0, 0, 0, 0, 0, 0, 0, 0, \

0, 0, 0, 0, 0, 0, 0 } } }

IPv6 address initializer.

◆ IN6ADDR_LOOPBACK_INIT

#define IN6ADDR_LOOPBACK_INIT

#include <zephyr/net/net_ip.h>

Value:

{ { { 0, 0, 0, 0, 0, 0, 0, \

0, 0, 0, 0, 0, 0, 0, 0, 1 } } }

IPv6 loopback address initializer.

◆ INADDR_ANY

#define INADDR_ANY 0

#include <zephyr/net/net_ip.h>

IPv4 any address.

◆ INADDR_ANY_INIT

#define INADDR_ANY_INIT { { { INADDR_ANY } } }

#include <zephyr/net/net_ip.h>

IPv4 address initializer.

◆ INADDR_BROADCAST

#define INADDR_BROADCAST 0xffffffff

#include <zephyr/net/net_ip.h>

IPv4 broadcast address.

◆ INADDR_LOOPBACK_INIT

#define INADDR_LOOPBACK_INIT { { { 127, 0, 0, 1 } } }

#include <zephyr/net/net_ip.h>

IPv6 loopback address initializer.

◆ INET6_ADDRSTRLEN

#define INET6_ADDRSTRLEN 46

#include <zephyr/net/net_ip.h>

Max length of the IPv6 address as a string.

Takes into account possible mapped IPv4 addresses.

◆ INET_ADDRSTRLEN

#define INET_ADDRSTRLEN 16

#include <zephyr/net/net_ip.h>

Max length of the IPv4 address as a string.

Defined by POSIX.

◆ net_ipaddr_copy

#define net_ipaddr_copy	(		dest,
			src )

#include <zephyr/net/net_ip.h>

Value:

UNALIGNED_PUT(UNALIGNED_GET(src), dest)

Copy an IPv4 or IPv6 address.

Parameters

dest	Destination IP address.
src	Source IP address.

Returns: Destination address.

◆ NET_IPV4_ADDR_SIZE

#define NET_IPV4_ADDR_SIZE 4

#include <zephyr/net/net_ip.h>

Binary size of the IPv4 address.

◆ NET_IPV6_ADDR_SIZE

#define NET_IPV6_ADDR_SIZE 16

#include <zephyr/net/net_ip.h>

Binary size of the IPv6 address.

◆ NET_MAX_PRIORITIES

#define NET_MAX_PRIORITIES 8

#include <zephyr/net/net_ip.h>

How many priority values there are.

◆ ntohl

#define ntohl ( x )

#include <zephyr/net/net_ip.h>

Value:

sys_be32_to_cpu(x)

sys_be32_to_cpu

#define sys_be32_to_cpu(val)

Convert 32-bit integer from big-endian to host endianness.

Definition byteorder.h:281

Convert 32-bit value from network to host byte order.

Parameters

x	The network byte order value to convert.

Returns: Host byte order value.

◆ ntohll

#define ntohll ( x )

#include <zephyr/net/net_ip.h>

Value:

sys_be64_to_cpu(x)

sys_be64_to_cpu

#define sys_be64_to_cpu(val)

Definition byteorder.h:287

Convert 64-bit value from network to host byte order.

Parameters

x	The network byte order value to convert.

Returns: Host byte order value.

◆ ntohs

#define ntohs ( x )

#include <zephyr/net/net_ip.h>

Value:

sys_be16_to_cpu(x)

sys_be16_to_cpu

#define sys_be16_to_cpu(val)

Convert 16-bit integer from big-endian to host endianness.

Definition byteorder.h:277

Convert 16-bit value from network to host byte order.

Parameters

x	The network byte order value to convert.

Returns: Host byte order value.

◆ PF_CAN

#define PF_CAN 4

#include <zephyr/net/net_ip.h>

Controller Area Network.

◆ PF_INET

#define PF_INET 1

#include <zephyr/net/net_ip.h>

IP protocol family version 4.

◆ PF_INET6

#define PF_INET6 2

#include <zephyr/net/net_ip.h>

IP protocol family version 6.

◆ PF_LOCAL

#define PF_LOCAL 6

#include <zephyr/net/net_ip.h>

Inter-process communication

◆ PF_NET_MGMT

#define PF_NET_MGMT 5

#include <zephyr/net/net_ip.h>

Network management info.

◆ PF_PACKET

#define PF_PACKET 3

#include <zephyr/net/net_ip.h>

Packet family.

◆ PF_UNIX

#define PF_UNIX PF_LOCAL

#include <zephyr/net/net_ip.h>

Inter-process communication

◆ PF_UNSPEC

#define PF_UNSPEC 0

#include <zephyr/net/net_ip.h>

Unspecified protocol family.

Typedef Documentation

◆ sa_family_t

typedef unsigned short int sa_family_t

#include <zephyr/net/net_ip.h>

Socket address family type.

◆ socklen_t

typedef size_t socklen_t

#include <zephyr/net/net_ip.h>

Length of a socket address.

Enumeration Type Documentation

◆ net_addr_state

enum net_addr_state

#include <zephyr/net/net_ip.h>

What is the current state of the network address.

Enumerator
NET_ADDR_ANY_STATE	Default (invalid) address type.
NET_ADDR_TENTATIVE	Tentative address
NET_ADDR_PREFERRED	Preferred address
NET_ADDR_DEPRECATED	Deprecated address

◆ net_addr_type

enum net_addr_type

#include <zephyr/net/net_ip.h>

How the network address is assigned to network interface.

Enumerator
NET_ADDR_ANY	Default value. This is not a valid value.
NET_ADDR_AUTOCONF	Auto configured address.
NET_ADDR_DHCP	Address is from DHCP.
NET_ADDR_MANUAL	Manually set address.
NET_ADDR_OVERRIDABLE	Manually set address which is overridable by DHCP.

◆ net_ip_mtu

enum net_ip_mtu

#include <zephyr/net/net_ip.h>

IP Maximum Transfer Unit.

Enumerator

NET_IPV6_MTU

IPv6 MTU length.

We must be able to receive this size IPv6 packet without fragmentation.

NET_IPV4_MTU

IPv4 MTU length.

We must be able to receive this size IPv4 packet without fragmentation.

◆ net_ip_protocol

enum net_ip_protocol

#include <zephyr/net/net_ip.h>

Protocol numbers from IANA/BSD.

Enumerator
IPPROTO_IP	IP protocol (pseudo-val for setsockopt()
IPPROTO_ICMP	ICMP protocol
IPPROTO_IGMP	IGMP protocol
IPPROTO_ETH_P_ALL	Every packet. from linux if_ether.h
IPPROTO_IPIP	IPIP tunnels
IPPROTO_TCP	TCP protocol
IPPROTO_UDP	UDP protocol
IPPROTO_IPV6	IPv6 protocol
IPPROTO_ICMPV6	ICMPv6 protocol.
IPPROTO_RAW	RAW IP packets

◆ net_ip_protocol_secure

enum net_ip_protocol_secure

#include <zephyr/net/net_ip.h>

Protocol numbers for TLS protocols.

Enumerator
IPPROTO_TLS_1_0	TLS 1.0 protocol.
IPPROTO_TLS_1_1	TLS 1.1 protocol.
IPPROTO_TLS_1_2	TLS 1.2 protocol.
IPPROTO_TLS_1_3	TLS 1.3 protocol.
IPPROTO_DTLS_1_0	DTLS 1.0 protocol.
IPPROTO_DTLS_1_2	DTLS 1.2 protocol.

◆ net_priority

enum net_priority

#include <zephyr/net/net_ip.h>

Network packet priority settings described in IEEE 802.1Q Annex I.1.

Enumerator
NET_PRIORITY_BK	Background (lowest)
NET_PRIORITY_BE	Best effort (default)
NET_PRIORITY_EE	Excellent effort
NET_PRIORITY_CA	Critical applications
NET_PRIORITY_VI	Video, < 100 ms latency and jitter.
NET_PRIORITY_VO	Voice, < 10 ms latency and jitter
NET_PRIORITY_IC	Internetwork control
NET_PRIORITY_NC	Network control (highest)

◆ net_sock_type

enum net_sock_type

#include <zephyr/net/net_ip.h>

Socket type.

Enumerator
SOCK_STREAM	Stream socket type
SOCK_DGRAM	Datagram socket type.
SOCK_RAW	RAW socket type

Function Documentation

◆ net_addr_ntop()

char * net_addr_ntop	(	sa_family_t	family,
		const void *	src,
		char *	dst,
		size_t	size )

#include <zephyr/net/net_ip.h>

Convert IP address to string form.

Parameters

family	IP address family (AF_INET or AF_INET6)
src	Pointer to struct in_addr if family is AF_INET or pointer to struct in6_addr if family is AF_INET6
dst	Buffer for IP address as a null terminated string
size	Number of bytes available in the buffer

Returns: dst pointer if ok, NULL if error

◆ net_addr_pton()

int net_addr_pton	(	sa_family_t	family,
		const char *	src,
		void *	dst )

#include <zephyr/net/net_ip.h>

Convert a string to IP address.

Parameters

family	IP address family (AF_INET or AF_INET6)
src	IP address in a null terminated string
dst	Pointer to struct in_addr if family is AF_INET or pointer to struct in6_addr if family is AF_INET6

Note: This function doesn't do precise error checking, do not use for untrusted strings.

Returns: 0 if ok, < 0 if error

◆ net_bytes_from_str()

int net_bytes_from_str	(	uint8_t *	buf,
		int	buf_len,
		const char *	src )

#include <zephyr/net/net_ip.h>

Convert a string of hex values to array of bytes.

The syntax of the string is "ab:02:98:fa:42:01"

Parameters

buf	Pointer to memory where the bytes are written.
buf_len	Length of the memory area.
src	String of bytes.

Returns: 0 if ok, <0 if error

◆ net_can_ptr()

static struct sockaddr_can_ptr * net_can_ptr ( const struct sockaddr_ptr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Get sockaddr_can_ptr from sockaddr_ptr.

This is a helper so that the code needing this functionality can be made shorter.

Parameters

addr	Socket address

Returns: Pointer to CAN socket address

◆ net_family2str()

const char * net_family2str ( sa_family_t family )

#include <zephyr/net/net_ip.h>

Return network address family value as a string.

This is only usable for debugging.

Parameters

family Network address family code

Returns: Network address family as a string, or NULL if family is unknown.

◆ net_if_ipv4_addr_lookup()

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

extern

#include <zephyr/net/net_ip.h>

◆ net_if_ipv4_addr_mask_cmp()

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

extern

#include <zephyr/net/net_ip.h>

◆ net_if_ipv4_is_addr_bcast()

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

extern

#include <zephyr/net/net_ip.h>

◆ net_if_ipv6_addr_lookup()

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

extern

#include <zephyr/net/net_ip.h>

◆ net_if_ipv6_maddr_lookup()

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

extern

#include <zephyr/net/net_ip.h>

◆ net_ipaddr_parse()

bool net_ipaddr_parse	(	const char *	str,
		size_t	str_len,
		struct sockaddr *	addr )

#include <zephyr/net/net_ip.h>

Parse a string that contains either IPv4 or IPv6 address and optional port, and store the information in user supplied sockaddr struct.

Syntax of the IP address string: 192.0.2.1:80 192.0.2.42

[2001:db8::2] 2001:db::42 Note that the str_len parameter is used to restrict the amount of characters that are checked. If the string does not contain port number, then the port number in sockaddr is not modified.

Parameters

str	String that contains the IP address.
str_len	Length of the string to be parsed.
addr	Pointer to user supplied struct sockaddr.

Returns: True if parsing could be done, false otherwise.

◆ net_ipv4_addr_cmp()

static bool net_ipv4_addr_cmp	(	const struct in_addr *	addr1,
		const struct in_addr *	addr2 )

inlinestatic

#include <zephyr/net/net_ip.h>

Compare two IPv4 addresses.

Parameters

addr1	Pointer to IPv4 address.
addr2	Pointer to IPv4 address.

Returns: True if the addresses are the same, false otherwise.

◆ net_ipv4_addr_cmp_raw()

static bool net_ipv4_addr_cmp_raw	(	const uint8_t *	addr1,
		const uint8_t *	addr2 )

inlinestatic

#include <zephyr/net/net_ip.h>

Compare two raw IPv4 address buffers.

Parameters

addr1	Pointer to IPv4 address buffer.
addr2	Pointer to IPv4 address buffer.

Returns: True if the addresses are the same, false otherwise.

◆ net_ipv4_addr_copy_raw()

static void net_ipv4_addr_copy_raw	(	uint8_t *	dest,
		const uint8_t *	src )

inlinestatic

#include <zephyr/net/net_ip.h>

Copy an IPv4 address raw buffer.

Parameters

dest	Destination IP address.
src	Source IP address.

◆ net_ipv4_addr_mask_cmp()

static bool net_ipv4_addr_mask_cmp	(	struct net_if *	iface,
		const struct in_addr *	addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given address belongs to same subnet that has been configured for the interface.

Parameters

iface	A valid pointer on an interface
addr	IPv4 address

Returns: True if address is in same subnet, false otherwise.

◆ net_ipv4_broadcast_address()

const struct in_addr * net_ipv4_broadcast_address ( void )

#include <zephyr/net/net_ip.h>

Return pointer to broadcast (all bits ones) IPv4 address.

Returns: Broadcast IPv4 address.

◆ net_ipv4_is_addr_bcast()

static bool net_ipv4_is_addr_bcast	(	struct net_if *	iface,
		const struct in_addr *	addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given IPv4 address is a broadcast address.

Parameters

iface	Interface to use. Must be a valid pointer to an interface.
addr	IPv4 address

Returns: True if address is a broadcast address, false otherwise.

◆ net_ipv4_is_addr_loopback()

static bool net_ipv4_is_addr_loopback ( struct in_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv4 address is a loopback address (127.0.0.0/8).

Parameters

addr	IPv4 address

Returns: True if address is a loopback address, False otherwise.

◆ net_ipv4_is_addr_mcast()

static bool net_ipv4_is_addr_mcast ( const struct in_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv4 address is a multicast address.

Parameters

addr	IPv4 address

Returns: True if address is multicast address, False otherwise.

◆ net_ipv4_is_addr_unspecified()

static bool net_ipv4_is_addr_unspecified ( const struct in_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv4 address is unspecified (all bits zero)

Parameters

addr	IPv4 address.

Returns: True if the address is unspecified, false otherwise.

◆ net_ipv4_is_ll_addr()

static bool net_ipv4_is_ll_addr ( const struct in_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given IPv4 address is a link local address.

Parameters

addr	A valid pointer on an IPv4 address

Returns: True if it is, false otherwise.

◆ net_ipv4_is_my_addr()

static bool net_ipv4_is_my_addr ( const struct in_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv4 address is assigned to any network interface in the system.

Parameters

addr	A valid pointer on an IPv4 address

Returns: True if IPv4 address is found in one of the network interfaces, False otherwise.

◆ net_ipv4_is_private_addr()

static bool net_ipv4_is_private_addr ( const struct in_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given IPv4 address is from a private address range.

See https://en.wikipedia.org/wiki/Reserved_IP_addresses for details.

Parameters

addr	A valid pointer on an IPv4 address

Returns: True if it is, false otherwise.

◆ net_ipv4_unspecified_address()

const struct in_addr * net_ipv4_unspecified_address ( void )

#include <zephyr/net/net_ip.h>

Return pointer to any (all bits zeros) IPv4 address.

Returns: Any IPv4 address.

◆ net_ipv6_addr_based_on_ll()

static bool net_ipv6_addr_based_on_ll	(	const struct in6_addr *	addr,
		const struct net_linkaddr *	lladdr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if given address is based on link layer address.

Returns: True if it is, False otherwise

◆ net_ipv6_addr_cmp()

static bool net_ipv6_addr_cmp	(	const struct in6_addr *	addr1,
		const struct in6_addr *	addr2 )

inlinestatic

#include <zephyr/net/net_ip.h>

Compare two IPv6 addresses.

Parameters

addr1	Pointer to IPv6 address.
addr2	Pointer to IPv6 address.

Returns: True if the addresses are the same, false otherwise.

◆ net_ipv6_addr_cmp_raw()

static bool net_ipv6_addr_cmp_raw	(	const uint8_t *	addr1,
		const uint8_t *	addr2 )

inlinestatic

#include <zephyr/net/net_ip.h>

Compare two raw IPv6 address buffers.

Parameters

addr1	Pointer to IPv6 address buffer.
addr2	Pointer to IPv6 address buffer.

Returns: True if the addresses are the same, false otherwise.

◆ net_ipv6_addr_copy_raw()

static void net_ipv6_addr_copy_raw	(	uint8_t *	dest,
		const uint8_t *	src )

inlinestatic

#include <zephyr/net/net_ip.h>

Copy an IPv6 address raw buffer.

Parameters

dest	Destination IP address.
src	Source IP address.

◆ net_ipv6_addr_create()

static void net_ipv6_addr_create	(	struct in6_addr *	addr,
		uint16_t	addr0,
		uint16_t	addr1,
		uint16_t	addr2,
		uint16_t	addr3,
		uint16_t	addr4,
		uint16_t	addr5,
		uint16_t	addr6,
		uint16_t	addr7 )

inlinestatic

#include <zephyr/net/net_ip.h>

Construct an IPv6 address from eight 16-bit words.

Parameters

addr	IPv6 address
addr0	16-bit word which is part of the address
addr1	16-bit word which is part of the address
addr2	16-bit word which is part of the address
addr3	16-bit word which is part of the address
addr4	16-bit word which is part of the address
addr5	16-bit word which is part of the address
addr6	16-bit word which is part of the address
addr7	16-bit word which is part of the address

◆ net_ipv6_addr_create_iid()

static void net_ipv6_addr_create_iid	(	struct in6_addr *	addr,
		struct net_linkaddr *	lladdr )

inlinestatic

#include <zephyr/net/net_ip.h>

Create IPv6 address interface identifier.

Parameters

addr	IPv6 address
lladdr	Link local address

◆ net_ipv6_addr_create_ll_allnodes_mcast()

static void net_ipv6_addr_create_ll_allnodes_mcast ( struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Create link local allnodes multicast IPv6 address.

Parameters

addr	IPv6 address

◆ net_ipv6_addr_create_ll_allrouters_mcast()

static void net_ipv6_addr_create_ll_allrouters_mcast ( struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Create link local allrouters multicast IPv6 address.

Parameters

addr	IPv6 address

◆ net_ipv6_addr_create_solicited_node()

static void net_ipv6_addr_create_solicited_node	(	const struct in6_addr *	src,
		struct in6_addr *	dst )

inlinestatic

#include <zephyr/net/net_ip.h>

Create solicited node IPv6 multicast address FF02:0:0:0:0:1:FFXX:XXXX defined in RFC 3513.

Parameters

src	IPv6 address.
dst	IPv6 address.

◆ net_ipv6_addr_create_v4_mapped()

static void net_ipv6_addr_create_v4_mapped	(	const struct in_addr *	addr4,
		struct in6_addr *	addr6 )

inlinestatic

#include <zephyr/net/net_ip.h>

Create IPv4 mapped IPv6 address.

Parameters

addr4	IPv4 address
addr6	IPv6 address to be created

◆ net_ipv6_addr_generate_iid()

int net_ipv6_addr_generate_iid	(	struct net_if *	iface,
		const struct in6_addr *	prefix,
		uint8_t *	network_id,
		size_t	network_id_len,
		uint8_t	dad_counter,
		struct in6_addr *	addr,
		struct net_linkaddr *	lladdr )

#include <zephyr/net/net_ip.h>

Generate IPv6 address using a prefix and interface identifier.

Interface identifier is either generated from EUI-64 (MAC) defined in RFC 4291 or from randomized value defined in RFC 7217.

Parameters

iface	Network interface
prefix	IPv6 prefix, can be left out in which case fe80::/64 is used
network_id	Network identifier (for example SSID in WLAN), this is optional can be set to NULL
network_id_len	Network identifier length, if set to 0 then the network id is ignored.
dad_counter	Duplicate Address Detection counter value, can be set to 0 if it is not known.
addr	IPv6 address
lladdr	Link local address

Returns: 0 if ok, < 0 if error

◆ net_ipv6_addr_is_v4_mapped()

static bool net_ipv6_addr_is_v4_mapped ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Is the IPv6 address an IPv4 mapped one.

The v4 mapped addresses look like ::ffff:a.b.c.d

Parameters

addr	IPv6 address

Returns: True if IPv6 address is a IPv4 mapped address, False otherwise.

◆ net_ipv6_addr_prefix_mask()

static void net_ipv6_addr_prefix_mask	(	const uint8_t *	inaddr,
		uint8_t *	outaddr,
		uint8_t	prefix_len )

inlinestatic

#include <zephyr/net/net_ip.h>

Get the IPv6 network address via the unicast address and the prefix mask.

Parameters

inaddr	Unicast IPv6 address.
outaddr	Prefix masked IPv6 address (network address).
prefix_len	Prefix length (max length is 128).

◆ net_ipv6_is_addr_loopback()

static bool net_ipv6_is_addr_loopback ( struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a loopback address (::1).

Parameters

addr	IPv6 address

Returns: True if address is a loopback address, False otherwise.

◆ net_ipv6_is_addr_mcast()

static bool net_ipv6_is_addr_mcast ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a multicast address.

Parameters

addr	IPv6 address

Returns: True if address is multicast address, False otherwise.

◆ net_ipv6_is_addr_mcast_all_nodes_group()

static bool net_ipv6_is_addr_mcast_all_nodes_group ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address belongs to the all nodes multicast group.

Parameters

addr	IPv6 address

Returns: True if the IPv6 multicast address belongs to the all nodes multicast group, false otherwise

◆ net_ipv6_is_addr_mcast_global()

static bool net_ipv6_is_addr_mcast_global ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a global multicast address (FFxE::/16).

Parameters

addr	IPv6 address.

Returns: True if the address is global multicast address, false otherwise.

◆ net_ipv6_is_addr_mcast_group()

static bool net_ipv6_is_addr_mcast_group	(	const struct in6_addr *	addr,
		const struct in6_addr *	group )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address belongs to certain multicast group.

Parameters

addr	IPv6 address.
group	Group id IPv6 address, the values must be in network byte order

Returns: True if the IPv6 multicast address belongs to given multicast group, false otherwise.

◆ net_ipv6_is_addr_mcast_iface()

static bool net_ipv6_is_addr_mcast_iface ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a interface scope multicast address (FFx1::).

Parameters

addr	IPv6 address.

Returns: True if the address is a interface scope multicast address, false otherwise.

◆ net_ipv6_is_addr_mcast_iface_all_nodes()

static bool net_ipv6_is_addr_mcast_iface_all_nodes ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a interface scope all nodes multicast address (FF01::1).

Parameters

addr	IPv6 address.

Returns: True if the address is a interface scope all nodes multicast address, false otherwise.

◆ net_ipv6_is_addr_mcast_link()

static bool net_ipv6_is_addr_mcast_link ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a link local scope multicast address (FFx2::).

Parameters

addr	IPv6 address.

Returns: True if the address is a link local scope multicast address, false otherwise.

◆ net_ipv6_is_addr_mcast_link_all_nodes()

static bool net_ipv6_is_addr_mcast_link_all_nodes ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a link local scope all nodes multicast address (FF02::1).

Parameters

addr	IPv6 address.

Returns: True if the address is a link local scope all nodes multicast address, false otherwise.

◆ net_ipv6_is_addr_mcast_mesh()

static bool net_ipv6_is_addr_mcast_mesh ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a mesh-local scope multicast address (FFx3::).

Parameters

addr	IPv6 address.

Returns: True if the address is a mesh-local scope multicast address, false otherwise.

◆ net_ipv6_is_addr_mcast_org()

static bool net_ipv6_is_addr_mcast_org ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is an organization scope multicast address (FFx8::).

Parameters

addr	IPv6 address.

Returns: True if the address is an organization scope multicast address, false otherwise.

◆ net_ipv6_is_addr_mcast_scope()

static bool net_ipv6_is_addr_mcast_scope	(	const struct in6_addr *	addr,
		int	scope )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a given scope multicast address (FFyx::).

Parameters

addr	IPv6 address
scope	Scope to check

Returns: True if the address is in given scope multicast address, false otherwise.

◆ net_ipv6_is_addr_mcast_site()

static bool net_ipv6_is_addr_mcast_site ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is a site scope multicast address (FFx5::).

Parameters

addr	IPv6 address.

Returns: True if the address is a site scope multicast address, false otherwise.

◆ net_ipv6_is_addr_solicited_node()

static bool net_ipv6_is_addr_solicited_node ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is solicited node multicast address FF02:0:0:0:0:1:FFXX:XXXX defined in RFC 3513.

Parameters

addr	IPv6 address.

Returns: True if the address is solicited node address, false otherwise.

◆ net_ipv6_is_addr_unspecified()

static bool net_ipv6_is_addr_unspecified ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 address is unspecified (all bits zero)

Parameters

addr	IPv6 address.

Returns: True if the address is unspecified, false otherwise.

◆ net_ipv6_is_global_addr()

static bool net_ipv6_is_global_addr ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given IPv6 address is a global address.

Parameters

addr	A valid pointer on an IPv6 address

Returns: True if it is, false otherwise.

◆ net_ipv6_is_ll_addr()

static bool net_ipv6_is_ll_addr ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given IPv6 address is a link local address.

Parameters

addr	A valid pointer on an IPv6 address

Returns: True if it is, false otherwise.

◆ net_ipv6_is_my_addr()

static bool net_ipv6_is_my_addr ( struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if IPv6 address is found in one of the network interfaces.

Parameters

addr	IPv6 address

Returns: True if address was found, False otherwise.

◆ net_ipv6_is_my_maddr()

static bool net_ipv6_is_my_maddr ( struct in6_addr * maddr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if IPv6 multicast address is found in one of the network interfaces.

Parameters

maddr Multicast IPv6 address

Returns: True if address was found, False otherwise.

◆ net_ipv6_is_prefix()

static bool net_ipv6_is_prefix	(	const uint8_t *	addr1,
		const uint8_t *	addr2,
		uint8_t	length )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if two IPv6 addresses are same when compared after prefix mask.

Parameters

addr1	First IPv6 address.
addr2	Second IPv6 address.
length	Prefix length (max length is 128).

Returns: True if IPv6 prefixes are the same, False otherwise.

◆ net_ipv6_is_private_addr()

static bool net_ipv6_is_private_addr ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given IPv6 address is from a private/local address range.

See https://en.wikipedia.org/wiki/Reserved_IP_addresses for details.

Parameters

addr	A valid pointer on an IPv6 address

Returns: True if it is, false otherwise.

◆ net_ipv6_is_same_mcast_scope()

static bool net_ipv6_is_same_mcast_scope	(	const struct in6_addr *	addr_1,
		const struct in6_addr *	addr_2 )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the IPv6 addresses have the same multicast scope (FFyx::).

Parameters

addr_1	IPv6 address 1
addr_2	IPv6 address 2

Returns: True if both addresses have same multicast scope, false otherwise.

◆ net_ipv6_is_sl_addr()

static bool net_ipv6_is_sl_addr ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given IPv6 address is a site local address.

Parameters

addr	A valid pointer on an IPv6 address

Returns: True if it is, false otherwise.

◆ net_ipv6_is_ula_addr()

static bool net_ipv6_is_ula_addr ( const struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Check if the given IPv6 address is a unique local address.

Parameters

addr	A valid pointer on an IPv6 address

Returns: True if it is, false otherwise.

◆ net_ipv6_pe_add_filter()

static int net_ipv6_pe_add_filter	(	struct in6_addr *	addr,
		bool	is_denylist )

inlinestatic

#include <zephyr/net/net_ip.h>

Add IPv6 prefix as a privacy extension filter.

Note that the filters can either allow or deny listing.

Parameters

addr	IPv6 prefix
is_denylist	Tells if this filter is for allowing or denying listing.

Returns: 0 if ok, <0 if error

◆ net_ipv6_pe_del_filter()

static int net_ipv6_pe_del_filter ( struct in6_addr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Delete IPv6 prefix from privacy extension filter list.

Parameters

addr	IPv6 prefix

Returns: 0 if ok, <0 if error

◆ net_ipv6_unspecified_address()

const struct in6_addr * net_ipv6_unspecified_address ( void )

#include <zephyr/net/net_ip.h>

Return pointer to any (all bits zeros) IPv6 address.

Returns: Any IPv6 address.

◆ net_port_set_default()

int net_port_set_default	(	struct sockaddr *	addr,
		uint16_t	default_port )

#include <zephyr/net/net_ip.h>

Set the default port in the sockaddr structure.

If the port is already set, then do nothing.

Parameters

addr	Pointer to user supplied struct sockaddr.
default_port	Default port number to set.

Returns: 0 if ok, <0 if error

◆ net_priority2vlan()

static uint8_t net_priority2vlan ( enum net_priority priority )

inlinestatic

#include <zephyr/net/net_ip.h>

Convert network packet priority to network packet VLAN priority.

Parameters

priority Packet priority

Returns: VLAN priority (PCP)

◆ net_rx_priority2tc()

int net_rx_priority2tc ( enum net_priority prio )

#include <zephyr/net/net_ip.h>

Convert Rx network packet priority to traffic class so we can place the packet into correct Rx queue.

Parameters

prio	Network priority

Returns: Rx traffic class that handles that priority network traffic.

◆ net_sin()

static struct sockaddr_in * net_sin ( const struct sockaddr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Get sockaddr_in from sockaddr.

This is a helper so that the code calling this function can be made shorter.

Parameters

addr	Socket address

Returns: Pointer to IPv4 socket address

◆ net_sin6()

static struct sockaddr_in6 * net_sin6 ( const struct sockaddr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Get sockaddr_in6 from sockaddr.

This is a helper so that the code calling this function can be made shorter.

Parameters

addr	Socket address

Returns: Pointer to IPv6 socket address

◆ net_sin6_ptr()

static struct sockaddr_in6_ptr * net_sin6_ptr ( const struct sockaddr_ptr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Get sockaddr_in6_ptr from sockaddr_ptr.

This is a helper so that the code calling this function can be made shorter.

Parameters

addr	Socket address

Returns: Pointer to IPv6 socket address

◆ net_sin_ptr()

static struct sockaddr_in_ptr * net_sin_ptr ( const struct sockaddr_ptr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Get sockaddr_in_ptr from sockaddr_ptr.

This is a helper so that the code calling this function can be made shorter.

Parameters

addr	Socket address

Returns: Pointer to IPv4 socket address

◆ net_sll_ptr()

static struct sockaddr_ll_ptr * net_sll_ptr ( const struct sockaddr_ptr * addr )

inlinestatic

#include <zephyr/net/net_ip.h>

Get sockaddr_ll_ptr from sockaddr_ptr.

This is a helper so that the code calling this function can be made shorter.

Parameters

addr	Socket address

Returns: Pointer to linklayer socket address

◆ net_tcp_seq_cmp()

static int32_t net_tcp_seq_cmp	(	uint32_t	seq1,
		uint32_t	seq2 )

inlinestatic

#include <zephyr/net/net_ip.h>

Compare TCP sequence numbers.

This function compares TCP sequence numbers, accounting for wraparound effects.

Parameters

seq1	First sequence number
seq2	Seconds sequence number

Returns: < 0 if seq1 < seq2, 0 if seq1 == seq2, > 0 if seq > seq2

◆ net_tcp_seq_greater()

static bool net_tcp_seq_greater	(	uint32_t	seq1,
		uint32_t	seq2 )

inlinestatic

#include <zephyr/net/net_ip.h>

Check that one TCP sequence number is greater.

This is convenience function on top of net_tcp_seq_cmp().

Parameters

seq1	First sequence number
seq2	Seconds sequence number

Returns: True if seq > seq2

◆ net_tx_priority2tc()

int net_tx_priority2tc ( enum net_priority prio )

#include <zephyr/net/net_ip.h>

Convert Tx network packet priority to traffic class so we can place the packet into correct Tx queue.

Parameters

prio	Network priority

Returns: Tx traffic class that handles that priority network traffic.

◆ net_vlan2priority()

static enum net_priority net_vlan2priority ( uint8_t priority )

inlinestatic

#include <zephyr/net/net_ip.h>

Convert network packet VLAN priority to network packet priority so we can place the packet into correct queue.

Parameters

priority VLAN priority

Returns: Network priority

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ AF_CAN

◆ AF_INET

◆ AF_INET6

◆ AF_LOCAL

◆ AF_NET_MGMT

◆ AF_PACKET

◆ AF_UNIX

◆ AF_UNSPEC

◆ CMSG_DATA

◆ CMSG_FIRSTHDR

◆ CMSG_LEN

◆ CMSG_NXTHDR

◆ CMSG_SPACE

◆ htonl

◆ htonll

◆ htons

◆ IN6ADDR_ANY_INIT

◆ IN6ADDR_LOOPBACK_INIT

◆ INADDR_ANY

◆ INADDR_ANY_INIT

◆ INADDR_BROADCAST

◆ INADDR_LOOPBACK_INIT

◆ INET6_ADDRSTRLEN

◆ INET_ADDRSTRLEN

◆ net_ipaddr_copy

◆ NET_IPV4_ADDR_SIZE

◆ NET_IPV6_ADDR_SIZE

◆ NET_MAX_PRIORITIES

◆ ntohl

◆ ntohll

◆ ntohs

◆ PF_CAN

◆ PF_INET

◆ PF_INET6

◆ PF_LOCAL

◆ PF_NET_MGMT

◆ PF_PACKET

◆ PF_UNIX

◆ PF_UNSPEC

Typedef Documentation

◆ sa_family_t

◆ socklen_t

Enumeration Type Documentation

◆ net_addr_state

◆ net_addr_type

◆ net_ip_mtu

◆ net_ip_protocol

◆ net_ip_protocol_secure

◆ net_priority

◆ net_sock_type

Function Documentation

◆ net_addr_ntop()

◆ net_addr_pton()

◆ net_bytes_from_str()

◆ net_can_ptr()

◆ net_family2str()

◆ net_if_ipv4_addr_lookup()

◆ net_if_ipv4_addr_mask_cmp()

◆ net_if_ipv4_is_addr_bcast()

◆ net_if_ipv6_addr_lookup()

◆ net_if_ipv6_maddr_lookup()

◆ net_ipaddr_parse()

◆ net_ipv4_addr_cmp()

◆ net_ipv4_addr_cmp_raw()

◆ net_ipv4_addr_copy_raw()

◆ net_ipv4_addr_mask_cmp()

◆ net_ipv4_broadcast_address()

◆ net_ipv4_is_addr_bcast()

◆ net_ipv4_is_addr_loopback()

◆ net_ipv4_is_addr_mcast()

◆ net_ipv4_is_addr_unspecified()

◆ net_ipv4_is_ll_addr()

◆ net_ipv4_is_my_addr()