Function Prototypes:tt6DevAddrNotifyFunc

Jump to: navigation, search

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.



Table of Contents >> IPv6 Programmer's Reference