NAME

landiag − local area network diagnostic

SYNOPSIS

landiag [-e] [-t]

DESCRIPTION

The landiag program is a diagnostic for the Local Area Network (LAN). 

In the LAN Interface Test Mode, a user can inquire about the status of the LAN interface card. This status includes the LAN interface card self-test completion code, the local network address, and some local LAN interface card statistics. Authorized operators can reset the local LAN interface card, causing it to execute its self-test. 

In the Remote Communications Test Mode, a user can initiate the exchange of messages between the local system and known remote nodes on the network.  The user 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 unique abbreviations.  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 identically to the Test Selection Mode terse command. The default for landiag is verbose. 

The commands available in the Test Selection Mode are:

lan Puts the diagnostic in LAN Interface Test 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 LAN Interface Test Mode are:

clear Clears the LAN interface card network statistics registers to zero.  Requires super-user status to execute. 

display Displays the local LAN interface card status and statistics registers. 

end Returns the diagnostic to the Test Selection Mode. 

menu Displays the LAN Interface Test Mode command menu. 

name Prompts for a device file name for the local LAN interface card. Default is /dev/lan. 

quit Terminates the landiag program. 

reset Resets the local LAN interface card which causes it to execute its self-test. Local access to the network is interrupted during execution of reset.  Requires super-user status to execute. 

The commands available in the Remote Communications Test Mode are:

name Prompts for the name of a node name file, and is used by the all command to determine which nodes to exchange messages with.  The node name file 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.

all Causes landiag to poll all nodes known to the local computer.  The list of nodes to be polled is taken from the node name file ( /etc/diagnodes ). 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 Returns the diagnostic to Test Selection Mode. 

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. Super-user status is required to set number to a value greater than 10.  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. 

DEPENDENCIES

Implemented on Series 300 computers only. 

AUTHOR

HP

SEE ALSO

lan(4), linkloop(1m), ping(1m), rlb(1m). 
 
 

Hewlett-Packard Company  —  May 11, 2021