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:
· 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.
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 ifcon‐
fig(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
Display 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 sys‐
tem (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 registers.
Menu Mode accepts either complete command words or unique abbrevia‐
tions, and no distinction is made between uppercase and lowercase let‐
ters 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 encoun‐
tered in an internal list. Appropriate values
can be displayed with the command (see lan‐
scan(1M)).
Terminate the program.
Reset the local LAN interface card, causing it to execute its
self-test.
Local access to the network is interrupted dur‐
ing 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. Appropri‐
ate values can be displayed with the command (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 ALSOnetstat(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)