unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 lanadmin(1M)							lanadmin(1M)




 NAME
      lanadmin - local area network administration program

 SYNOPSIS
      /usr/sbin/lanadmin [-e] [-t]

      /usr/sbin/lanadmin [-a] [-A station_addr] [-b] [-B on|off ]
	   [-m] [-M mtu_size] [-R] [-s] [-S speed] [-x options] [-X options]
	   PPA

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

	+  Display and change the station address.
	+  Display and change the 802.5 Source Routing options (RIF).
	+  Display and change the maximum transmission unit (MTU).
	+  Display and change the speed setting.
	+  Clear the network statistics registers to zero.
	+  Display the interface statistics.
	+  Reset the interface card, thus executing its self-test.

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

      lanadmin 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 ^C) interrupts a currently executing command; the eof key
      (usually ^D) terminates the program.

      lanadmin operates in two modes: Menu Mode (see the first SYNOPSIS
      line) and Immediate Mode (see the second SYNOPSIS line).	If at least
      one -aAbBmMRsS option is supplied, lanadmin executes in Immediate
      Mode.  Otherwise, it executes in Menu Mode.

      NOTE: lanadmin replaces the now obsolete landiag command beginning at
      10.0.

    Options and Arguments
      lanadmin recognizes the following Immediate Mode options and
      arguments.  At least one -aAbBmMRsS option and the PPA argument must
      be supplied.

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




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 lanadmin(1M)							lanadmin(1M)




	   -a		       Display the current station address of the
			       interface corresponding to PPA.

	   -A station_addr     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 have superuser privileges.  When
			       station_addr is DEFAULT, 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.

	   -b		       Display the current 802.5 source routing
			       option for the interface corresponding to
			       PPA.

	   -B on|off	       Turn the 802.5 source routing option ``on''
			       or ``off'' for the interface corresponding to
			       PPA. The default value for HP devices is
			       ``on''.	You must have superuser privileges.

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

	   -M mtu_size	       Set the new MTU size of the interface
			       corresponding to PPA. The mtu_size value must
			       be within the link specific range.  You must
			       have superuser privileges.

	   -R		       Reset the MTU size of the interface
			       corresponding to PPA to the default for that
			       link type.  You must have superuser
			       privileges.

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

	   -S speed	       Set the new link speed setting of the
			       interface corresponding to PPA. You must have
			       superuser privileges.

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





 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 lanadmin(1M)							lanadmin(1M)




	   -X options	       Set driver specific options of the interface
			       corresponding to PPA.  You must have
			       superuser privileges.

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

	   -e		       Echo the input commands on the output device.

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

    Immediate Mode
      In Immediate Mode, you can display the station address, source routing
      option, MTU size, and link speed of LAN interface PPA. For certain
      interfaces, if you have superuser privileges you can also modify the
      station address, source routing option, MTU size, and link speed.	 See
      "Options and Arguments" 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 registers.

      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:

	   lan		  Select the LAN Interface Test Mode menu.

	   menu		  Display the Test Selection Mode command menu.

	   quit		  Terminate the lanadmin program.

	   terse	  Suppress the display of command menus.

	   verbose	  Restore the display of command menus.

      LAN Interface Test Mode Menu

      The following commands are available:

	   clear	   Clear the LAN interface network statistics
			   registers to zero.  You must have superuser



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 lanadmin(1M)							lanadmin(1M)




			   privileges.

	   display	   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.

	   end		   Return lanadmin to Test Selection Mode.

	   menu		   Display the LAN Interface Test Mode command menu.

	   ppa		   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
			   lanscan command (see lanscan(1M)).

	   quit		   Terminate the lanadmin program.

	   reset	   Reset the local LAN interface card, causing it to
			   execute its self-test.  Local access to the
			   network is interrupted during execution of reset.
			   You must have superuser privileges.

	   specific	   Display and execute commands from a driver
			   specific menu.

 WARNINGS
      Changes made to an interface's station address or mtu interactively
      with the lanadmin 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 SAM interface.

 AUTHOR
      lanadmin was developed by HP.

 SEE ALSO
      netstat(1), lanscan(1M), linkloop(1M), ping(1M), lan(7).

      IETF Requests for Comments: RFC 1213, RFC 1398.












 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000