Requires Optional LAN Software

NAME

linkloop − verify LAN connectivity with link-level loopback

SYNOPSIS

linkloop [−n count] [−f devfile] [−t timeout] [−s size] [−v] linkaddr1 [linkaddr2 ...]

DESCRIPTION

linkloop uses IEEE 802.3 link-level test frames to check connectivity within a local area network (LAN).  This program differs from the remote loopback capability of rlb(1M) in that it tests only link-level connectivity; not transport-level connectivity.

The required parameter is the link-level address (linkaddr1, linkaddr2,...) of a remote node. linkloop tests the connectivity of the local node and the remote node specified by the link-level address.  The link-level address of a remote node can be found by executing lanscan on the remote node.  This link-level address is usually represented as a hexadecimal string prefixed with 0x, but can also be represented as a octal string prefixed with 0 or as a decimal string.  The address must not be a multicast or broadcast address (the least significant bit of the first byte of the link address must be zero). 

Options

linkloop recognizes the following options:

−n count Sets the number of frames to transmit.  If count is zero, linkloop transfers frames indefinitely until an interrupt signal (defined by the user shell) is received.  The default value for count is one. 

−t timeout Sets the amount of time (in seconds) to wait for a reply from the remote node before aborting.  If timeout is zero, linkloop waits indefinitely for a reply.  The default value for timeout is 2 seconds. 

−s size Sets the size of the data message to send.  The maximum data size is 1497, which is also the default size. 

−v Sets the verbose option.  In addition to the regular summary of test results, this option displays more extensive error information.  If there are header or length errors, appropriate messages are displayed.  All verbose output is preceded by the number of replies accepted before an error occurred. 

−f devfile Specifies which device file to use.  The device file must be an IEEE 802.3 device file.  If no device file is entered, linkloop uses /dev/lan (Series 300/400) as the default.  If /dev/lan is not present or is the wrong type of device file, linkloop uses /dev/ieee (Series 300/400) as the default.  If no device file is entered, linkloop uses /dev/lan0 (Series 700) as the default.  If /dev/lan0 is not present or is the wrong type of device file, linkloop uses /dev/ieee0 (Series 700) as the default. 

linkloop aborts upon receipt of an interrupt signal.  If aborted, the current results are printed. 

linkloop prints the result of the link-level connectivity test.  If the test fails, it prints a summary of the test and indicates the type of error.  The possible messages are:

address has bad format
Incorrect link address was entered on the command line.

address is not individual
Link address entered on the command line does not have the least significant bit of the first byte set to 0.

frames sent
Total number of frames sent.

frames received correctly
Total number of frames received without errors.

frames with length error
Received frame length does not match transmitted frame length. If the verbose option is set, the length received is printed.

frames with data error
Received frame does not match transmitted frame.

frames with header error
Number of frames received containing unexpected frame header information. Either the source address does not match the remote address, the destination address does not match the local address, or the control field is not the TEST frame control field.  These frames are ignored.  linkloop continues to try to receive the reply frame until the read operation times out. 

reads that timed out
Count of how many read operations timed out before the reply was received. 

DIAGNOSTICS

illegal count parameter
count is not a non-negative integer, or the number specified is too large for the local computer. 

illegal timeout parameter
timeout is not a non-negative integer, or the number specified multiplied by 1000 is too large for the local computer. 

illegal size parameter
Size specified is not in the range of 0..1497.

unable to use device file
Specified device file does not exist or is of the wrong type, or linkloop is already being executed by another user. 

unable to use default device file
Default device file does not exist or is of the wrong type, or linkloop is already being executed by another user. 

AUTHOR

linkloop was developed by HP. 

FILES

/dev/lan first default device file for Series 300/400

/dev/ieee second default device file for Series 300/400 /dev/lan0 first default device file for Series 700

/dev/ieee0 second default device file for Series 700

SEE ALSO

lanscan(1M), lan(7). 

Hewlett-Packard Company  —  HP-UX Release 8.05: June 1991