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)).
- -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.
- .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.
- -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.
You must have superuser privileges.
- -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.
- -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 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.