Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

Find the best matched source address in the IPv6 configured host addresses for the specified destination address.

Files

net_ipv6.h/net_ipv6.c

Prototype

Code Block
          NET_IPv6_ADDRS NetIPv6_GetAddrSrc(NET_IF_NBR     *p_if_nbr,
                                            NET_IPv6_ADDR  *p_addr_src,
                                            NET_IPv6_ADDR  *p_addr_dest,
                                            NET_IPv6_ADDR  *p_addr_nexthop,
                                            NET_ERR        *p_err);

Arguments

p_if_nbr

Pointer to a variable to : 

      1.  Pass the interface number to use for transmission,
        Pass NULL otherwise.
      2. Return the interface number associated with the selected source address.

p_addr_src

Pointer to a variable to : 

Pass a suggested IPv6 source address,
Pass NULL otherwise.

p_addr_dest

Pointer to the IPv6 destination address.

p_addr_nexthop

Pointer to an IPv6 address that will received the Next Hop IPv6 address found in the process of founding the best source address.

...

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

NET_IPv6_ERR_NONE
NET_IPv6ERR_ERRFAULT_NULL_PTR
NET_IPv6_ERR_TX_NEXT_HOP_NONE
NET_IPv6_ERR_ADDR_NONE_AVAIL
NET_IPv6_ERR_ADDR_CFG_IN_PROGRESS
NET_IPv6_ERR_ADDR_TBL_SIZE
NET_IF_ERR_INVALID_IF
NET_IPv6_ERR_TX_SRC_SEL_FAIL

NET_ERR_FAULT_LOCK_ACQUIRE

Returned Value

Pointer to the IPv6 addresses object associated with the best source address for the specified destination.

Required Configuration

None.

Notes / Warnings

None.