tfFinishConfigInterface

Jump to: navigation, search

Table of Contents >> Programmer's Reference


#include <trsocket.h>


int tfFinishConfigInterface (
ttUserInterface interfaceHandle,
ttUserIpAddress ipAddress,
ttUserIpAddress netMask,
int mhomeIndex
);


Function Description

This function finishes configuring an interface that the user started to configure with tfConfigInterface with the TM_DEV_IP_USER_BOOT flag on a given multihome index.


Parameters

  • interfaceHandle
    This is the interface handle.
  • ipAddress
    This is the IP address with which to configure the interface at multihome index 0.
  • netMask
    This is the IP netmask of the IP address to configure.
  • mhomeIndex
    This is the multihome index.


Returns

  • TM_EINVAL
    This indicates failure. The kernel found invalid arguments in the call.
  • TM_ENOBUFS
    This indicates failure due to a failed memory allocation.
  • TM_EALREADY
    This indicates failure because the ipAddress/ipNetMask is already in the routing table.
  • TM_EPERM
    This indicates failure because the user did not call tfOpenInterface or tfConfigInterface with TM_DEV_IP_USER_BOOT..
  • TM_EADDRNOTAVAIL
    This indicates failure because the ipAddress/ipNetMask is a broadcast address.
  • TM_ENOERROR
    This indicates success.


Usage

This new function allows the user to configure AUTO IP on any multihome using tfConfigInterface with TM_DEV_IP_USER_BOOT. This also allows the user to configure BOOTP or DHCP addresses acquired with the user BOOTP or DHCP interface at any multihome index. This function finishes configuring an interface that the user started to configure with tfConfigInterface with the TM_DEV_IP_USER_BOOT flag on a given multihome index. This flag keeps the Treck stack from storing the IP address/netmask in the routing table leaving the interface half configured. This function attempts to insert the ipAddress/ipNetMask into the routing table.

Table of Contents >> Programmer's Reference