mipadmin(1M)															      mipadmin(1M)

NAME

       mipadmin - Mobile IPv4 administration utility

SYNOPSIS

       conf_file]

       [option]

       level]

       level]

DESCRIPTION

       is  a program for performing Mobile IPv4 administration tasks, such as starting and stopping Mobile IPv4 daemons and getting information on
       various system parameters.  The tool can interact with Mobile IPv4 daemons mipd(1M) and miprod(1M).  Only root user can run

       When is started, the tool first reports the name and PID of the Mobile IPv4 daemon running on the system, if any.  Based  on  this  report,
       the  user  is  restricted  on the options that can be used.  For instance, most reporting options cannot be used when no daemon is running.
       Another example is that the option cannot be used if a Mobile IPv4 daemon is found running.

   Options
       recognizes the following options.  These can be given as command line arguments or as commands in a session. To start  a  session,  execute
       without any command line arguments.

       options can be classified into two kinds: Administrative and Reporting.

   Administrative Options
       These  options must be used exclusively, that is, they cannot be used with other administrative or reporting options.  These options can be
       used at the command line or at the session prompt.

       (Abbr.:			Start a Mobile IPv4 daemon.

				and specify the daemon to start.  Note that will verify that the daemon is running before allowing use of  certain
				reporting  options.   If  no daemon is specified with this option, is the default daemon.  (mobility agent) starts
				and (correspondent node) starts and cannot both be started on the same system, since only one daemon can run on  a
				single system.	If is started, the user will be notified if any interface is restarted with enabled.

       (Abbr.:			Specify  the  configuration  file  the	daemon should use.  If no file is specified, the tool will start with (see
				mipd.conf(4)) and with (see miprod.conf(4)).

       (Abbr.:			Stop a Mobile IPv4 daemon.  If the daemon stopped is will query it for the list of interfaces on which	it  offers
				services.   These  interfaces  have enabled, which can be disabled once is stopped.  These interfaces will be dis-
				played to the user and will be restarted with disabled if the daemon is stopped.

       (Abbr.			Obtain help on options.

				option specifies the option for which help is required.

       (Abbr.:			Exit the session.

   Reporting Options
       Multiple reporting options may be specified at the command line or can be concatenated to form commands at  the	session  prompt.   Options
       that report information from the daemon can be used only when a Mobile IPv4 daemon is running.

       Unless  stated  otherwise  in  the description, the option applies to both and Exceptions on the usage of an option is based on the type of
       daemon currently running.  Certain options may apply only to while others only to Even in the case of some options may apply  depending	on
       the daemon's configuration with respect to AAA functionality.  offering AAA functionality is said to be in 'AAA-mode'.  This terminology is
       used in the option descriptions below.  Note that can operate in two modes: normal and AAA-mode.  The option can be used to verify the mode
       of operation.

       (Abbr.:		   Report  configuration  information  from the daemon.  Note that this information is not reported from the configuration
			   file.  For a list  of  configuration  information,  see  mipconfig(1M)  or  mipd.conf(4)  for  and  miproconfig(1M)	or
			   miprod.conf(4) for

			   (Abbr.:	     Global configuration information.	For this information includes any AAA data.

			   (Abbr.:	     Information  on all security associations configured on the daemon.  For these include security asso-
					     ciations to mobile or correspondent nodes.  For the information is for all home agents.

			   (Abbr.:	     Information on all interfaces configured on the daemon.  For these include all  interfaces  on  which
					     Mobility  Services  are offered.  For information is reported for the interface that is the source IP
					     address for all tunnels created.

			   (Abbr.:	     Reports all configuration data.  It is also the default option if	the  user  does  not  specify  any
					     option.

       (Abbr.:		   This option applies only to It reports any home agent mobility bindings information.

			   The option sets display mode to verbose.

       (Abbr.:		   This option applies only to It reports foreign agent visitor list information.

			   The option sets display mode to verbose.

       (Abbr.:		   Report general information and statistical counters from the daemon.

			   The option resets statistical counters to 0.

       (Abbr.:		   Report  events  (if any) logged by daemon in syslogd(1M).  This option may be used even when no daemon is running.  The
			   daemon whose events are reported is selected according to the following rules:

			   If a daemon is specified, then the most recent instance of this daemon that has logged entries in syslog  is  selected.
			   If daemon is unspecified and a daemon is currently running, then the the daemon currently running is selected.  If dae-
			   mon is unspecified and no daemon is currently running, then the most recent instance of that has logged entries in sys-
			   log is selected.

			   selects the most recent instance of
				  that logged entries into and selects the most recent instance of that logged entries into

			   (Abbr.:
				  The  class  of events to display.  If this option is not used, then the events logged under all classes are dis-
				  played.  The level parameter may be repeated multiple times.	Note that for each input to level, only events for
				  that	class  are displayed.  That is, events below this class in the event class hierarchy (if any) are not dis-
				  played.

				  (Abbr.:  These messages include unrecoverable error conditions such as fatal	configuration  errors  and  daemon
					   initialization errors.

				  (Abbr.:  These messages include recoverable error conditions including some Mobile Node registration failures.

				  (Abbr.:  These  messages  include  conditions  such as dropped packets due to unsupported features, or no system
					   resources.

				  (Abbr.:  These messages provide detailed event logging for debugging and troubleshooting purposes.

       (Abbr.:		   Report contents of router advertisement messages sent out by This option applies only to

			   The option sets display mode to verbose.

       (Abbr.:		   Report or change a daemon's logging level.

			   (Abbr.:
				  The new logging level will include any log levels below it in the hierarchy.	The logging levels (from lowest to
				  highest) are:

				  (Abbr.:  These  messages  include  unrecoverable  error conditions such as fatal configuration errors and daemon
					   initialization errors.

				  (Abbr.:  These messages include recoverable error conditions including some Mobile Node registration failures.

				  (Abbr.:  These messages include events such as dropped  packets  due	to  unsupported  features,  or	no  system
					   resources.

				  (Abbr.:  These messages provide detailed event logging for debugging and troubleshooting purposes.

       (Abbr.:		   Report  information on any tunnels created by or For acting as a Foreign agent, this displays the tunnels from the For-
			   eign agent to the Home Agents.  For acting as a Home Agent, this displays the tunnels from the Home Agent to  the  For-
			   eign Agents, and to Mobile nodes using a co-located address.  For the tunnels report displays the tunnels from the Cor-
			   respondent node to the Foreign Agent and to the Mobile nodes using a co-located address.  This option may be used  even
			   when no daemon is running.

			   The option sets display mode to verbose.

       (Abbr.:		   Report version information from the daemon.

       (Abbr.:		   Report  route  optimization information from the daemon.  For it reports the Binding Update messages sent to correspon-
			   dent nodes.	For the option reports the Correspondent Node's Binding Cache.

			   The option sets display mode to verbose.

       (Abbr.:		   This option applies only to operating in AAA-mode.  It reports information from the	dynamic  home  address	pools  (if
			   any).  Information includes addresses in the pool and whether or not they have been allocated to a Mobile Node (identi-
			   fied by NAI).

       (Abbr.:		   This option applies only to operating in AAA-mode.  It reports information on any active AAA sessions maintained by the
			   daemon.

			   The option sets display mode to verbose.

   AUTHOR
       was developed by Hewlett-Packard Company.

   SEE ALSO
       mipd(1M), mipconfig(1M), miproconfig(1M), miprod(1M), mipd.conf(4), miprod.conf(4).

																      mipadmin(1M)