tfFinishConfigInterface

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