lanadmin(1M)

NAME

lanadmin − local area network administration program

SYNOPSIS

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

/usr/sbin/lanadmin [−a] [−A station_addr] [−m] [−M mtu_size] [−R] [−s] [−S speed]
NetMgmtID

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.

• 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 -aAmMRsS option is supplied, lanadmin executes in Immediate Mode. Otherwise, it executes in Menu Mode.

Options and Arguments

lanadmin recognizes the following Immediate Mode options and arguments. At least one -aAmMRsS option and the NetMgmtID argument must be supplied.

NetMgmtID The Network Management ID number of the LAN interface. This argument is ignored if none of the -aAmMRsS options is used (Menu Mode). Any options specified after NetMgmtID are ignored. Appropriate values can be displayed with the lanscan command (see lanscan(1M)).

−a Display the current station address of the interface corresponding to NetMgmtID.

−A station_addr Set the new station address of the interface corresponding to NetMgmtID. The station_addr must be entered in hex format with a ’0x’ prefix. You must have superuser privileges.

−m Display the current MTU size of the interface corresponding to NetMgmtID.

−M mtu_size Set the new MTU size of the interface corresponding to NetMgmtID. 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 NetMgmtID to the default for that link type. You must have superuser privileges.

−s Display the current speed setting of the interface corresponding to NetMgmtID.

−S speed Set the new speed setting of the interface corresponding to NetMgmtID. 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, MTU size, and link speed of LAN interface NetMgmtID. For certain interfaces, if you have superuser privileges you can also modify the station address, 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 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.

nmid Prompt for a Network Management ID 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.

AUTHOR

lanadmin was developed by HP.

Museum

Related Articles