Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administration Commandsmipagentstat(1M)


NAME

 mipagentstat - show Mobile IP Mobility Agent status

SYNOPSIS

 mipagentstat [-fhp]

DESCRIPTION

 

Use the mipagentstat utility to display the content of various Mobile-IP related data structures.

Visitor Table (First Form)

 

The visitor table display lists information for all mobile nodes registered with the foreign agent, one mobile node per line. This list consists of the mobile node's home address or Network Access Identifier (NAI), home agent address, total registration lifetime and the number of seconds remaining before the registration expires.

The following command line shows the output from a foreign agent with two mobile nodes registered:
 
example# mipagentstat -f

Mobile Node     Foreign Agent  Time Granted    Time Remaining     Flags
                              (in secs)        (in secs)          
foobar@xyz.com  fa1@tuv.com    600             125
10.1.5.23       123.2.5.12     1000            10                 R
An "R" in the flags column indicates a reverse tunnel is present. No reverse tunnel is configured for the mobile node foobar@xyz.com. A reverse tunnel is configured from mobile node 10.1.5.23.

Binding Table (Second Form)

 

The binding table display lists information for all mobile nodes registered with the home agent, one mobile node per line. This list consists of the mobile node's home address or NAI, foreign agent address, total registration lifetime and the number of seconds remaining before the registration expires.

Use the following command line to show the output from a home agent with two active mobile nodes:

 
example# mipagentstat -h

Mobile Node     Home Agent     Time Granted    Time Remaining     Flags
                              (in secs)       (in secs)         
foobar@xyz.com  ha1@xyz.com   600             125
10.1.5.23       10.1.5.1      1000            10                 R

An "R" in the flags column indicates a reverse tunnel is present. No reverse tunnel is configured for the mobile node foobar@xyz.com. A reverse tunnel is configured for mobile node 10.1.5.23.

Agent Table (Third Form)

 

The agent table display lists information for all current mobility agent-peers, that is all mobility agents with which mobile-nodes we are servicing are trying to obtain service.

Provided in this display are the IPsec protection mechanisms being used with registration requests, replies, and tunnels.

Use the following command line to show the output from a home agent with two (foreign) mobility agent peers:

 
example# mipagentstat -hp

Foreign                    ..... Security Association(s).....
Agent                      Requests Replies  FTunnel  RTunnel
------------------------   -------- -------- -------- --------
fa.eng.sun.com             AH,ESP   AH,ESP   AH,ESP   AH,ESP
fa.central.sun.com         AH       AH       ESP      ESP

Use the following command line to show the output from a home agent with two (foreign) mobility agent peers:

 
example# mipagentstat -fp

Home                       ..... Security Association(s) .....
Agent                      Requests Replies  FTunnel  RTunnel
------------------------   -------- -------- -------- --------
ha.eng.sun.com             AH,ESP   AH,ESP   AH,ESP   AH,ESP
ha.central.sun.com  

Use of the -p option without specifying the agent results in both displays described above, that is one display for each agent.

An AH in any column indicates the IPsec AH mechanism is in place for those datagrams.

An ESP in any column indicates the IPsec ESP mechanism is in place for those datagrams.

OPTIONS

 

The following options are supported:

-f
Display the list of active mobile nodes in the foreign agent's visitor's list.
-h
Display the list of active mobile nodes in the home agent's binding table.
-p
Display the list of mobility agent peers, and the IPsec protection mechanisms currently in use for registration and tunnel traffic.

EXIT STATUS

 

The following exit values are returned:

0
Successful completion.
non-zero
An error occurred.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWmipu

SEE ALSO

 

mipagent(1M), mipagentconfig(1M), mipagent.conf(4), attributes(5)

Aboda, B., and Beadles, M. RFC 2486, The Network Access Identifier. The Internet Society, 1999.


SunOS 5.9Go To TopLast Changed 11 Dec 2001

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.