manpages.info - online man pages   

SunOS man pages : mipagent (1)

Maintenance Commands                                 mipagent(1M)

NAME

mipagent - Mobile IP agent

SYNOPSIS

/usr/lib/inet/mipagent

DESCRIPTION

The mipagent utility implements the Mobile IP home agent and foreign agent functionality described in RFC 2002, IP Mobil- ity Support. The term "mobility agent" is used to refer to the home agent and foreign agent functionality collectively. mipagent responds to Mobile IP registration and deregistra- tion requests and router discovery solicitation messages from a mobile node. Besides responding to external messages, the mipagent utility also tasks on a periodic basis, such as aging the mobility bindings and visitor entries and sending agent advertisements. The mobility agent can also handle direct delivery style reverse tunneling as specified in RFC 2344, Reverse Tunneling for Mobile IP. Limited private address support for mobile nodes is also available. Run the mipagent daemon as root using the start-up script, which has the following syntax: example# /etc/init.d/mipagent [start|stop] /etc/inet/mipagent.conf must be present before you start-up the mipagent daemon. See mipagent.conf(4). At start up, mipagent reads the configuration information from /etc/inet/mipagent.conf. The mipagent daemon records a con- tinuous log of its activities by means of syslog(). See syslog(3C). You can use the LogVerbosity parameter in /etc/inet/mipagent.conf to control the verbosity level of the log. The mipagent daemon can be terminated either by the script: example# /etc/init.d/mipagent stop or by the kill command. Periodically while running, or if terminated or shutdown, the mipagent daemon stores the following internal state information in /var/inet/mipagent_state: o a list of the mobile nodes supported as home agents; o their current care-of addresses; and o the remaining registration lifetimes.If the mipagent SunOS 5.8 Last change: 12 Dec 2000 1 Maintenance Commands mipagent(1M) utility is terminated for maintenance and restarted, mipagent_state is used to recreate as much of the mobility agent's internal state as possible. This minimizes service disruption for mobile nodes that may be visiting other networks. If mipagent_state exists, it is read immediately after mipagent.conf when mipagent is restarted. The format of mipagent_state is undocumented since it is likely to change and programs other than mipagent should not use it for any purpose. A separate utility program mipagentstat is provided for monitoring mipagent.

EXIT STATUS

The following exit values are returned: 0 The daemon started successfully. -1 The daemon failed to start.

FILES

/etc/inet/mipagent.conf Configuration file for Mobile IP mobility agent. /var/inet/mipagent_state File where private state information from mipagent is stored. /etc/init.d/mipagent [start|stop] mipagent start-up script.

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWmipu | |_____________________________|_____________________________|

SEE ALSO

mipagentstat(1M), mipagentconfig(1M), syslog(3C), mipagent.conf(4), attributes(5) Montenegro, G., editor.RFC 2344, Reverse Tunneling for Mobile IP. Network Working Group. May 1998. Perkins, C. RFC 2002, IP Mobility Support. Network Working Group. October 1996. SunOS 5.8 Last change: 12 Dec 2000 2 Maintenance Commands mipagent(1M)

DIAGNOSTICS

The mipagent utility exits with an error if the configura- tion file, mipagent.conf, cannot be read successfully. Upon receiving a SIGTERM or SIGINT signal, mipagent cleans its internal state, including any changes to the routing and ARP tables, and exits.

NOTES

The foreign agent adds host- specific local routes to its routing table for visiting mobile nodes after they are suc- cessfully registered. If a visiting mobile node departs without sending a de-registration message through the foreign agent, these routing entries persist until the mobile node's previous registration expires. Any packets that arrive at the foreign agent for the departed mobile node during this time, for example because the foreign agent is also a router for the foreign network, will be lost. Sys- tem administrators can configure foreign agents to accept only short registration lifetimes. This will automatically restrict the maximum duration for which a departed mobile node will be temporarily unreachable. SunOS 5.8 Last change: 12 Dec 2000 3