LANDIAG(1) LANDIAG(1)
NAME
landiag - local area network diagnostic
SYNOPSIS
landiag [-e] [-t]
HP-UX COMPATIBILITY
Level: HP-UX/NON-STANDARD
Origin: HP
DESCRIPTION
The landiag program is a diagnostic for the Local Area
Network (LAN).
In the Local LAN Interface Status mode, an operator can
inquire about the status of the LAN Interface controller
attached to the local computer. This status includes the LAN
Interface controller selftest completion code, the local
network address, and some local LAN Interface controller
statistics. Authorized operators can reset the local LAN
Interface controller, causing it to execute its self test.
In the Remote Communications Test mode, an operator can
initiate the exchange of messages between the local system
and known remote nodes on the network. The operator can
exchange messages with specified nodes or automatically poll
all nodes known to the local computer. Parameters such as
message length, number of messages, timeout value and
display of message round trip times can be set.
Commands are read from stdin, prompts and error messages are
written to stderr, and status and message exchange displays
are written to stdout. The BREAK key can be used to
generate an interrupt of a currently executing command, if
initiated interactively. If commands are read from a file,
CTRL-| causes control to return to the shell.
Landiag accepts either complete command words or certain
abbreviations. On Series 500 computers, commands can be
abbreviated to one letter. On Series 200 and 300 computers,
commands can be abbreviated to one or more letters.
Commands are case insensitive. Multiple commands can be
entered on one line if they are separated by blanks, tabs or
commas.
The options are:
-e Echo the input commands on the output device.
-t Suppress the display of the command menu before
each command prompt. This option functions
Hewlett-Packard - 1 - (printed 7/16/86)
LANDIAG(1) LANDIAG(1)
identically to the Test Selection mode terse
command. The default for landiag is verbose.
Landiag is entered from the Test Selection mode. The
available Test Selection mode commands are:
lan Puts the diagnostic in Local LAN Interface
Status mode.
menu Displays the Test Selection mode command menu.
quit Terminates the landiag program.
remote Puts the diagnostic in Remote Communications
Test mode.
terse Suppresses display of command menus.
verbose Restores default display of command menus.
The commands available in the Local LAN Interface Status
mode are:
clear Clears the LAN Interface controller network
statistics registers to zero. Requires an
effective userID of super-user.
display Displays the local LAN Interface controller
status and statistics registers.
end Puts the diagnostic in the Test Selection mode.
menu Displays the Local LAN Interface Status mode
command menu.
name Prompts for a device file name for the local
LAN Interface controller.
quit Terminates the landiag program.
reset Resets the local LAN Interface controller which
causes it to execute its selftest. Local access
to the network is interrupted during execution
of reset. Requires an effective userID of
super-user.
The commands available in the Remote Communications Test
mode are:
name Series 200 and 300 computers only. Prompts for
the name of a node name file, which contains
node names, and is used by the all command to
Hewlett-Packard - 2 - (printed 7/16/86)
LANDIAG(1) LANDIAG(1)
determine which nodes to exchange messages
with. The node name file takes the place of
the Series 500 Network Directory. It must be
an ASCII text file and have the following
format:
One node name per line.
Each node name can be followed by a
comment.
Each node name consists of the name field,
and the optional environment and
organization fields, which are separated
by periods.
Each field of the node name can be up to
16 alphanumeric characters in length and
must begin with an alphabetic character.
Empty node names are not allowed.
bounce Series 500 computers only. Causes message
exchanges with itself by performing a bounce
back at the LAN Interface. Requires an
effective userID of super-user. Bounce tests
the computer's network software and hardware,
including the transceiver. On Series 200 and
300 computers, the test of the hardware
including the transceiver, is automatically
included in the interface card hard reset. The
Series 200 and 300 test does not test the
network software.
all Causes landiag to poll all nodes known to the
local computer. The list of nodes to be polled
is taken from the local network directory on a
Series 500 computer and from the node name file
on a Series 200 or 300 computer. The node name
file is specified with the Remote Communication
Test mode's name command.
continue
Forces landiag to continue message exchanges
with a remote node, even if transmit/receive
message data differ. The default is to
terminate the exchange if the data differ.
display Causes landiag to compute and display the
message round trip times. Round trip time is
the time messages take to make the round trip
between the local node and a remote node. The
operator can enter a trigger value to control
how often the times are displayed. The default
for display is off.
end Puts the diagnostic in the Test Selection mode.
Hewlett-Packard - 3 - (printed 7/16/86)
LANDIAG(1) LANDIAG(1)
length Prompts for a new message length for the
messages to be exchanged with remote nodes.
The default length is 100 bytes and the maximum
length is 1450 bytes.
menu Displays the Remote Communications Test mode
command menu.
number Prompts for a new value for the number of
messages to be exchanged with remote nodes.
The default value is 1. To set number to a
value greater than 10, an effective userID of
super-user is required. The maximum allowable
number is (2**31)-1.
quit Terminates the landiag program.
single Prompts for a node name and then executes
message exchanges with that remote node.
timeout Prompts for a new timeout value, which
determines how long landiag waits for a
response from a remote node. The default value
is 10 seconds. The maximum allowable timeout
value is 600 seconds.
SEE ALSO
lan(4).
HP Network Services/9000 LAN Node Managers Guide
Hewlett-Packard - 4 - (printed 7/16/86)