@CHIP-RTOS C Library - TCP/IP API

Dev_Config_Iface_IPv6

IPv6 configuration of an interface

int Dev_Config_Iface_IPv6(DevIpv6IfaceCfg far * devcfg, int *error);

Parameters

devcfg

DevIpv4IfaceCfg filled by the caller. Contains the device handle,IPv6 configuration and the multihomeindex number.

error

Output parameter:  Failure code, 0 on success.

Return Value

0: success,
-1: failed

Comments

This functions provides the possibility to configure a device interface (e.g. the standard internal ethernet interface) with multiple IPv6 addresses by enter a particular multihome index number.   If an interface is already configured at the specified multihomeindex number, the user first has to unconfigure it with Dev_UnConfig_Iface().   DHCP configuration of a device is only possible at multihomeindex 0.

It is recommended to use this function only for changing the IP configuration on either your own device interfaces or on the internal Ethernet interface for multihomeindex 1..4.

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

On SC1x3/SC2x (RTOS version >=1.13, CLIB version >=2.10) there's also a version of this function which uses dynamic linking instead of a software interrupt, which reduces the function's overhead and thus speeds up your application. This function's name is Dev_Config_Iface_IPv6_Dyn. You should however not use this function directly. Instead you should add the define TCPIP_DYN_LINK_DEV to your program before including the CLIB's header file(s):

#define TCPIP_DYN_LINK_DEV
#include <clib.h>

This will map the original function's name to the dynamic linking version. This way you can also easily switch existing programs to dynamic linking.

Related Topics

TCP/IP Device Driver overview

Supported since or modified in @CHIP-RTOS version

SC12	SC13	SC11	SC1x3	SC2x
n/a	n/a	n/a	V1.05	V1.00

Supported by @CHIP-RTOS C Library since version

CLIB
V2.04