Function Prototypes:tt6DevAddrNotifyFunc
Table of Contents >> IPv6 Programmer's Reference
#include <trsocket.h> |
void (TM_CODE_FAR * tt6DevAddrNotifyFunc) | ( |
ttUserInterface interfaceHandle, | |
unsigned int multiHomeIndex, | |
struct sockaddr_storage * ipv6AddrPtr, | |
int event | |
); |
Function Description
This is the type definition for the IPv6-specific address notification function. A function of this type may be registered with tfNgOpenInterface() or tfNgConfigInterface(). This allows the user to be notified of IPv6-specific address related events, as described below.
Parameters
- interfaceHandle
- A handle to the interface on which the event occurred.
- multiHomeIndex
- The multihome that the specified address is configured at.
- ipv6AddrPtr
- The IPv6 address that underwent the specified event.
- event
- The IPv6 address event. See below.
IPv6 Address Configuration Events
- TM_6_DEV_ADDR_CONFIG_STARTED
- Configuration of the IPv6 address has been started. Duplicate Address Detection is being performed on the tentative address.
- TM_6_DEV_ADDR_CONFIG_FAILED
- Duplicate Address Detection failed. A different node is already using the tentative address we tried to configure, therefore configuration failed.
- TM_6_DEV_ADDR_CONFIG_COMPLETE
- Duplicate Address Detection succeeded. Configuration of the IPv6 address on the interface completed successfully.
- TM_6_DEV_ADDR_DUP_DETECTED
- The Treck stack detected that a different node is using one of your IPv6 addresses that was successfully configured (i.e. for which the TM_6_DEV_ADDR_CONFIG_COMPLETE event has occurred). It is up to the user to specify what recovery, if any, is performed when this event occurs. ([RFC 2462])
- TM_6_DEV_ADDR_PREFERRED
- An auto-configured IPv6 address has transitioned state from deprecated to preferred.
- TM_6_DEV_ADDR_DEPRECATED
- An auto-configured IPv6 address has transitioned state from preferred to deprecated.
- TM_6_DEV_ADDR_INVALIDATED
- An auto-configured IPv6 address has transitioned state to invalid, and has been unconfigured from the interface.
- TM_6_DEV_ADDR_ALL_RELEASED
- An DHCPv6 address has been released and unconfigured from the interface.
- TM_6_DEV_ADDR_ALL_DECLINED
- An DHCPv6 address has been declined and not configured on the interface.
- TM_6_DEV_DHCP_KEY_NOT_FOUND
- DHCPv6 client does not have the key requested by the server to complete the authentication process.
- TM_6_DEV_DHCP_KEY_EXPIRED
- DHCPv6 client has the key requested by the server, but it has expired and the client is not able to complete the authentication process.
- TM_6_DEV_ADDR_RTR_SOL_FAILED
- Router Solicitation timed out with no Router Advertisement response. You must define TM_6_RTR_SOL_FAIL_CB in trsystem.h to receive this event. You will not receive this event if you have specified TM_6_DEV_USER_DHCP_RTR_CTRLD when you opened the interface.