mipagentstat(1M)

NAME

     mipagentstat - show Mobile IP Mobility Agent status

SYNOPSIS

     mipagentstat [-fhp]

DESCRIPTION

     Use the mipagentstat utility to display the content of vari-
     ous 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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWmipu                    |
    |_____________________________|_____________________________|

SEE ALSO

     mipagent(1M), mipagentconfig(1M),  mipagent.conf(4),  attri-
     butes(5)

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