linkloop(1M)															      linkloop(1M)

NAME

       linkloop - verify LAN connectivity with link-level loopback

SYNOPSIS

       PPA] count] rif] size] timeout] linkaddr ...

   Remarks
       The and commands are deprecated.  See for more information.

DESCRIPTION

       The command uses IEEE 802.2 link-level test frames to check connectivity within a local area network (LAN).

       linkaddr is the hardware station address of a remote node.  Several addresses can be specified at one time.

       tests the connectivity of the local node and the remote node specified by each hardware station address.  The hardware station address of a
       remote node can be found by executing on the remote node.  This hardware station address is usually represented	as  a  hexadecimal  string
       prefixed  with It can also be represented as a octal string prefixed with or as a decimal string.  The hardware station address must not be
       a multicast or broadcast address.

   Options
       recognizes the following options:

	      Specify the    PPA to use.  If this option is omitted, uses the first PPA it encounters in an internal data structure.

	      Set the number of frames to transmit.
			     If count is transfers frames indefinitely until an interrupt signal (defined by the user  shell)  is  received.   The
			     default value for count is

	      Specify the particular bridge route
			     over  which  token  ring  packets should be delivered.  rif is the routing information field used for token-ring net-
			     works.  Its value is given as an even number of hexadecimal bytes separated by colons, up to a maximum of 16 bytes.

	      Set the size in bytes of the data message to send.
			     The maximum data size is dependent on the type of LAN link being used.  The default value is the  maximum	data  byte
			     count that can be used for the particular link.

	      Set the amount of time in seconds to wait for a reply
			     from the remote node before aborting.  If timeout is waits indefinitely for a reply.  The default value is 2 seconds.

	      Set 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.

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

       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:

	      An incorrect hardware station address was entered on the command line.

	      The station address entered on the command line is either a multicast or broadcast address.

	      Total number of frames sent.

	      Total number of frames received without errors.

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

	      Received frame does not match transmitted frame.

	      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.  continues to try to receive the reply frame until the operation times out.

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

DIAGNOSTICS

	      The count specified in the option is a negative integer, or the number specified is too large for the local computer.

	      The timeout specified in the option is a negative integer, or the value specified multiplied by 1000 is too large for the local com-
	      puter.

	      The size specified in the option is not in the range from 0 to the maximum link data size.  Remember that the maximum link data size
	      can vary in value for different LAN connection types.  The current MTU can be obtained with the command.

	      The PPA specified in the option is not a valid PPA.

	      Device file does not exist.

	      The rif value in the option is invalid.

	      The number of bytes in rif in the option exceeded 16, which is the maximum allowed.

	      The number of bytes in rif in the option is odd.	The number of bytes must be even.

WARNINGS

       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 ALSO

       lanadmin(1M), lanscan(1M), nwmgr(1M), lan(7).

								  TO BE OBSOLETED						      linkloop(1M)