NetIPv6_CfgAddrAdd

Description

Add a statically-configured IPv6 host address to an interface.

Files

net_ipv6.h/net_ipv6.c

Prototype

          CPU_BOOLEAN NetIPv6_CfgAddrAdd(NET_IF_NBR      if_nbr,
                                         NET_IPv6_ADDR  *p_addr,
                                         CPU_INT08U      prefix_len,
                                         NET_FLAGS       flags,
                                         NET_ERR        *p_err);

Arguments

if_nbr

Interface number to configure.

p_addr

Pointer to desired IPv6 address to add to this interface.

prefix_len

Prefix length of the desired IPv6 address to add to this interface.

flags

Set of flags to select options for the address configuration: 

NET_IPv6_FLAG_BLOCK_EN   Enables blocking mode if set.
NET_IPv6_FLAG_DAD_EN       Enables Duplication Address Detection (DAD) if set.

p_err

Pointer to variable that will receive the error code from this function:

NET_IPv6_ERR_NONE
NET_IPv6_ERR_DAD_DISABLED
NET_IPv6_ERR_ADDR_CFG_IN_PROGRESS
NET_IPv6_ERR_ADDR_CFG_DUPLICATED
NET_IPv6_ERR_INVALID_ADDR_CFG_MODE
NET_IPv6_ERR_ADDR_CFG_STATE
NET_IPv6_ERR_ADDR_TBL_FULL
NET_IPv6_ERR_ADDR_CFG_IN_USE
NET_IPv6_ERR_INVALID_ADDR_HOST
NET_IPv6_ERR_INVALID_ADDR_PREFIX_LEN
NET_INIT_ERR_NOT_COMPLETED
NET_IF_ERR_INVALID_IF
NET_ERR_FAULT_LOCK_ACQUIRE

Returned Value

DEF_OK, if valid IPv6 address configured.

DEF_FAIL, otherwise.

Required Configuration

None.

Notes / Warnings

None.