lanadmin(1M)

NAME

lanadmin — local area network administration program

SYNOPSIS

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

/usr/sbin/lanadmin [-a] [-A station_addr] [-c] [-g [get_options]] [-m] [-M mtu_size] [-p] [-r] [-R] [-s] [-S speed] [-V vlan_options [parms]] [-x options] [-X options] PPA

Remarks

The lanadmin, lanscan, and linkloop commands are deprecated. See WARNINGS for more information.

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 maximum transmission unit (MTU).
Display and change the speed setting.
Clear the network statistics registers to zero.
Display the interface statistics.
Display the interface usage information.
Reset the interface card, thus executing its self-test.
Configure VLANs on the cards that support VLAN.

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 of aAcgmMprRsSVxX options is supplied, lanadmin executes in Immediate Mode. Otherwise, it executes in Menu Mode.

Options

lanadmin recognizes the following Immediate Mode options. At least one aAcgmMprRsSVxX option and the PPA argument must be supplied.

-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 be a privileged user. When station_addr is DEFAULT, the factory default physical address will be restored.

.CR

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.

-c

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

-g [get_options]

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 mibstats and mibstats_ext.

mibstats: Display the MIB-II statistics (RFC 1213) and interface specific statistics.
mibstats_ext: Display extended 64-bit MIB statistics (RFC 2863) and interface-specific statistics.

-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 be a privileged user.

-p

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.

-r

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.

-R

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

-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 be a privileged user.

-V vlan_options

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: Create a VLAN.
modify: Modify the properties of a VLAN.
delete: Delete a VLAN.
scan: Display information about all VLANs on a system.
info: Display information about a particular VLAN on a system.
basevppa: Display the minimum acceptable virtual PPA (VPPA) value.

-x options

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

-X options

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

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, 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 Options 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 be a privileged user.
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 be a privileged user.
specific: Display and execute commands from a driver specific menu.

Arguments

lanadmin 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 aAcgmMprRsSVxX options are used (Menu Mode). Any options specified after PPA are ignored. Appropriate values can be displayed with the lanscan command (see lanscan(1M)).

WARNINGS

Changes made to an interface's station address or mtu 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.

Obsolescence

The lanadmin, lanscan, and linkloop 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

lanadmin was developed by HP.