tfSetReachable

Jump to: navigation, search

Table of Contents >> IPv6 Programmer's Reference


#include <trsocket.h>


int tfSetReachable (
struct sockaddr_storage * addrPtr,
ttUserInterface interface,
int * reachableMsecPtr
);


Function Description

Applications call this function periodically to notify Neighbor Unreach-ability Detection of the reach-ability of a peer node. Essentially, this allows applications to "refresh" the ARP cache entry that is used when sending to the peer. [RFC 2461]


Parameters

  • addrPtr
    IP address of a peer node that the application has received reach-ability confirmation for in the form of "forward progress"; it could be a neighbor, or a remote node reachable through router(s). If the peer node is a neighbor, the reach-ability for the neighbor will be set to REACHABLE, otherwise the reach-ability for the first-hop router in the path to the peer node is set to REACHABLE.
  • interface
    Only needed when addrPtr is an IPv6 local scope address. This identifies the outgoing interface that the address specified by addrPtr is reachable through.
  • reachableMsecPtr
    Output parameter; if not NULL, then the new reachable time (in milliseconds) of the matching ARP cache entry will be stored here on return.


Returns

  • TM_ENOERROR
    Success
  • TM_EINVAL
    addrPtr was NULL, or addrPtr points to a local scope IPv6 address but interface was invalid.
  • TM_ENOENT
    No ARP entry exists for the specified peer IP address; send some packets first to the peer to cause the ARP entry to be created.


Table of Contents >> IPv6 Programmer's Reference