lanadmin(1M)															      lanadmin(1M)

NAME

       lanadmin - local area network administration program

SYNOPSIS

       station_addr] [get_options]] mtu_size] speed] vlan_options [parms]] options] options] PPA

   Remarks
       The and commands are deprecated.  See for more information.

DESCRIPTION

       The program administers and tests the Local Area Network (LAN).	For each interface card, it allows you to:

	 o  Display and change the station address.
	 o  Display and change the maximum transmission unit (MTU).
	 o  Display and change the speed setting.
	 o  Clear the network statistics registers to zero.
	 o  Display the interface statistics.
	 o  Display the interface usage information.
	 o  Reset the interface card, thus executing its self-test.
	 o  Configure VLANs on the cards that support VLAN.

       For operations other than display, you must have superuser privileges.

       reads  commands from standard input, writes prompts and error messages to standard error, and writes status information to standard output.
       When the program is run from a terminal, the interrupt key (usually interrupts a currently executing command; the eof key  (usually  termi-
       nates the program.

       operates  in  two  modes: Menu Mode (see the first line) and Immediate Mode (see the second line).  If at least one of options is supplied,
       executes in Immediate Mode.  Otherwise, it executes in Menu Mode.

   Options
       recognizes the following Immediate Mode options.  At least one option and the PPA argument must be supplied.  Display the  current  station
       address of the interface corresponding to PPA.

       Set the new station address of the interface corresponding to
	      PPA.   The  station_addr must be entered in hex format with a '0x' prefix.  You must be a privileged user.  When station_addr is the
	      factory default physical address will be restored.

       WARNING: To ensure the interface and the system work correctly, the
	      interface MUST be brought down before setting the new station address.  After the new station address is set, the  interface  should
	      be brought up in order to be functional.	See ifconfig(1M) for bringing down and bringing up the interface.

       Clear the LAN interface network statistics registers to zero for
	      the interface corresponding to PPA.  You must be a privileged user.

       Get and display settings corresponding to options specified by
	      get_options of the interface corresponding to PPA.  get_options is optional and is case insensitive. The allowed values are and Dis-
	      play the MIB-II statistics (RFC 1213) and interface specific statistics.

       Display extended 64-bit MIB statistics (RFC 2863)
	      and interface-specific statistics.

       Display the current MTU size of the interface corresponding to
	      PPA.

       Set the new MTU size of the interface corresponding to
	      PPA.  The mtu_size value must be within the link specific range.	You must be a privileged user.

       Display the usage information for the interface corresponding to
	      PPA.  Displays the upper level protocols and applications attached to the interface corresponding to PPA.  If none is  attached,	it
	      prints nothing.

       Reset the local LAN interface card corresponding to
	      PPA,  causing  it  to  execute  its self-test.  Local access to the network is interrupted during execution of reset.  You must be a
	      privileged user.

       Reset the MTU size of the interface corresponding to
	      PPA to the default for that link type.  You must be a privileged user.

       Display the current link speed setting of the interface corresponding to
	      PPA.

       Set the new link speed setting of the interface corresponding to
	      PPA.  You must be a privileged user.

       Executes VLAN-specific options; some options require specific
	      parameters (parms).  See vlan(7) for complete syntax and usage of this option.  The supported vlan_options are: Create a VLAN.

       Modify the properties of a VLAN.

       Delete a VLAN.

       Display information about all VLANs on a system.

       Display information about a particular VLAN on a system.

       Display the minimum acceptable virtual PPA (VPPA) value.

       Get and display driver specific
	      options of the interface corresponding to PPA.

       Set driver specific
	      options of the interface corresponding to PPA.  You must be a privileged user.

       recognizes the following Menu Mode options.  They are ignored if they are given with an Immediate Mode option.

       Echo the input commands on the output device.

       Suppress the display of the command menu before each command prompt.
	    This is equivalent to the Test Selection Mode command.  The default is

   Immediate Mode
       In Immediate Mode, you can display the station address, MTU size, link speed of LAN interface PPA/VPPA and information about VLANs  on  the
       system  (see  vlan(7)).	 For  certain interfaces, if you are a privileged user you can also modify the station address, MTU size, and link
       speed.  See above.

   Menu Mode
       In Menu Mode, you can select an interface card, display statistics for the selected card, reset the card, and clear the	statistics  regis-
       ters.

       Menu Mode accepts either complete command words or unique abbreviations, and no distinction is made between uppercase and lowercase letters
       in commands.  Multiple commands can be entered on one line if they are separated by spaces, tabs, or commas.

       Test Selection Mode Menu

       This menu is entered when Menu Mode is first selected.  The available Test Selection Mode commands are:

	      Select the LAN Interface Test Mode menu.

	      Display the Test Selection Mode command menu.

	      Terminate the  program.

	      Suppress the display of command menus.

	      Restore the display of command menus.

       LAN Interface Test Mode Menu

       The following commands are available:

	      Clear the LAN interface network statistics registers to zero.
			      You must be a privileged user.

	      Display the RFC 1213 MIB II statistics.
			      Depending on the link, the type-specific MIB statistics may also be displayed.  For instance,  for  Ethernet  links,
			      the RFC 1398 Ethernet-like statistics are displayed.

	      Return	      to Test Selection Mode.

	      Display the LAN Interface Test Mode command menu.

	      Prompt for a    PPA  that  corresponds  to  a LAN interface card.  It defaults to the first LAN interface encountered in an internal
			      list.  Appropriate values can be displayed with the command (see lanscan(1M)).

	      Terminate the   program.

	      Reset the local LAN interface card, causing it to execute its self-test.
			      Local access to the network is interrupted during execution of You must be a privileged user.

	      Display and execute commands from a driver
			      menu.

   Arguments
       recognizes the following Immediate Mode argument.

       PPA		   The Physical Point of Attachment (PPA) number of the LAN interface.	This argument is ignored if none  of  the  options
			   are	used (Menu Mode).  Any options specified after PPA are ignored.  Appropriate values can be displayed with the com-
			   mand (see lanscan(1M)).

WARNINGS

       Changes made to an interface's station address or mtu with the command will not be preserved between system reboots.  A	user  must  modify
       the initialization configuration files for this feature, either manually editing configuration files or through the interface.

   Obsolescence
       The  and  commands are deprecated.  These commands will be removed in a future HP-UX release.  HP recommends the use of replacement command
       nwmgr(1M) to perform all network interface-related tasks.

AUTHOR

       was developed by HP.

SEE ALSO

       netstat(1), ifconfig(1M), lanscan(1M), linkloop(1M), nwmgr(1M), ping(1M), lan(7), vlan(7).

       IETF Requests for Comments: RFC 1213, RFC 1398, RFC 2863.

								  TO BE OBSOLETED						      lanadmin(1M)