miproconfig(1M) 														   miproconfig(1M)

NAME

       miproconfig - Mobile IPv4 Route Optimization daemon configuration utility

SYNOPSIS

       [ conf_file ]

       display_file ]

DESCRIPTION

       is  a configuration tool for Mobile IPv4 Route Optimization daemon, miprod(1M).	The tool gathers data from the user and generates configu-
       ration files formatted specifically for Only root user can run

   Options
       recognizes the following command-line options and arguments:

	      conf_file 	This will start a configuration session.  If conf_file is not provided, is used as default.  If  the  target  file
				exists,  then its contents are read and stored in the session records.	The process of reading the file is similar
				to the option (non-fatal errors will be flagged and fatal errors will cause immediate termination of the process).
				If  the  file  does  not  exists,  session records are initialized to zero and the user can create a new file from
				scratch.

				Note that specifying conf_file does not necessarily imply that the file will be modified; the user  will  have	to
				explicitly commit session records. The user can specify any file name at that time.

	      Displays the contents of a configuration file.  If a file is not specified, the
				contents  of  will  be	displayed (if the file exists).  informs the user of any syntax or data type errors in the
				file.  Fatal errors will cause immediate termination of the reading process and all data read  up  to  this  point
				will  be  displayed  to  the user.  The tool restricts the size of each line of the file to 250 characters and the
				maximum length of any non-commented token to 60 characters.

   Commands
       sessions support the following commands.  For commands that take arguments, user can input arguments in the novice  mode  by  entering  the
       command name without any arguments.  In novice mode, user can get help for any input by typing in "?" at the prompt.

       commands  can  be classified into three categories.  Users are required to input values for command arguments unless the descriptions state
       when input is not required, or describe the default behavior of when the information is not configured.

   Configuration Commands
       These commands are of the form: and The commands can be used to configure or update individual sets of information (e.g.  a  Tunnel  Inter-
       face).  The commands can be used to delete one or more sets of information (for example, multiple Home Agents).
       (Abbr.: Configure or update a Home Agent.  This command will automatically configure the replay protection scheme to Timestamps.

	      ip_addr	     IP address of Home Agent.

	      Index to identify the Security Association (SA) between the
			     Home Agent and Must be a positive 32-bit integer greater than 255 and match the SPI configured on the Home Agent.

	      The algorithm association with this Security Association (SA). The input "md5"
			     configures  the MD5 algorithm while the input "hmac-md5" configures the HMAC-md5 algorithm. By default mipconfig con-
			     figures the HMAC-md5 algorithm.

	      Used by	     to authenticate the Home Agent's identity.  This 128-bit value should be specified as a sequence of  16  2-digit  hex
			     values  separated	by spaces.  Or, an input of "random" will generate a random key for the user.  This key must match
			     the key configured on the Home Agent.

       (Abbr.:
	      Configure or update an interface whose IP address will be used as the source of all tunnels created by This  configuration  informa-
	      tion is optional.  If not entered, will do a call to determine an IP address to use as the source address for all tunnels.

	      name	     Name  of  interface  (maximum  16 characters) whose address will be used as the source of all tunnels.  Users will be
			     warned if interface is not on the machine (UP, not POINTOPOINT or LOOPBACK).

	      Primary address of interface.  Constitutes source address of all tunnels
			     created by The user needs to input this information if the interface is not (UP, not POINTOPOINT or LOOPBACK).

       (Abbr.:
	      Delete one or more Home Agents.

	      ip_addr	     IP address of Home Agent to delete.  Omit this input to delete all Home Agents.

       (Abbr.:
	      Delete interfaces configured as source of tunnels.

       (Abbr.:
	      Delete all session records.

   List Commands
       These commands list information for various configuration data.
       (Abbr.: Display information for one or more Home Agents.

	      ip_addr	     IP Address of Home Agent to list.	Omit this input to list all Home Agents.

       (Abbr.:
	      Display information for interface configured as source of tunnels created by

       (Abbr.:
	      Display all session data.

   Session Commands
       The remaining commands can be classified as session commands.
       (Abbr.: Perform bulk configuration using commands from a file.  Users should ensure that the commands in the file are valid.

	      conf_file      Name of the file that contains configuration commands.

       (Abbr.:
	      Create a configuration file for from session data.  Users will be warned if configuration data is incomplete or not matching  system
	      parameters.

	      filename	     Name of the file to create.

       (Abbr.:
	      Exit from

	      This switch must be specified to force the command when there is unsaved data.

       (abbr.:
	      Obtain syntax and brief description of commands.

	      Use this switch as the first argument to get help on any arguments of
			     command.  This switch applies to every command specified by the user.

	      command	     Command  for  which  help	is needed. User may repeat this argument as needed.  Omit this argument to get list of all
			     commands supported.

       (Abbr.:
	      Clear the session display screen (similar to the command).

       (Abbr.:
	      Display overview of process to configure

       (Abbr.:
	      Display name and address of all interfaces on the system (UP, not POINTOPOINT or LOOPBACK).  This command may be used  to  correctly
	      configure the tunnel source interface.

   EXAMPLES
       Start a miproconfig session by reading

       Configure a Home Agent 123.5.6.4 with spi 500 and a specific key

       Delete Home Agent 123.5.6.8

       Quit session without saving file.

       Display contents of default configuration file

   Example Sessions
       Configure a Correspondent Node in a network with one Home Agent, 15.15.15.4.  (The network topology was simplified for the purposes of this
       example.)

	      # miproconfig

	      Creating /var/adm/mip/miprod.conf

	      miproconfig> c h 15.15.15.4 -spi 1025 -k r

	      Random key: 6c 4e 8d 26 25 72 82 2b b3 ad 35 63 5b 70 4e d0

	      NOTE: replay protection for Home Agent 15.15.15.4
	      has been set to timestamps

	      miproconfig> write

	      Configuration file name (/var/adm/mip/miprod.conf): <CR>

	      miproconfig> quit

	      #

   AUTHOR
       was developed by Hewlett-Packard Company.

   SEE ALSO
	miprod(1M), miprod.conf(4).

																   miproconfig(1M)