/* 
* Copyright (c) 2004 by Sun Microsystems, Inc.
* All rights reserved.
*/ 

TEST NAME 

      lsalr_6 - test network load bearing on IPv6

SYNOPSIS 

      sh lsalr_6.sh REMOTE-MACHINE INSTANCES ITERATIONS

DESCRIPTION 

      This test initiates several simultaneous directory-listing processes on a
      remote machine to test network load bearing.

      This test initiates several remote 'ls -alR' commands that run
      concurrently in the background.

OPERANDS 

       REMOTE-MACHINE  Either the host name or IPv6 address of the machine to
                       which files and directories are copied. If the host
                       name is given, it must appear in /etc/inet/ipnodes along
                       with the remote machine's IPv6 address.

USAGE VARIABLES

	RUNTIME	This environment variable specifies, in seconds, the duration
		of the test. This variable is required only on the client side.

SETUP 

      You need two machines connected by a network, either back-to-back, or
      through a hub or switch.

OUTPUT 

      This test indicates its progress before and after each test iteration,
      and ends by displaying the total time the test ran.

DURATION 

      24 hours

POSSIBLE CONCURRENT TESTS 

      * This test is usually run alongside a second test to further stress the
        driver/NIC.

      * The runtime period should be judged so as to run for as long as the
        concurrent tests are running, but if run independently, then 24 hours
        is sufficient.

      * This test can run concurrently with cl3se3_6, ftptest, mpflip, and spray_6.

NOTES 

      This test might cause a problem if it runs too quickly, in that it
      consumes all available sockets. After a socket is closed, the socket
      stays in the TIME_WAIT state for up to 2 minutes, during which it cannot
      be reused. For this reason, the test alters the tcp_time_wait_interval 
      to a lower value as it runs.

EXAMPLES 

      $ env RUNTIME=60 lsalr_6.sh fe80::a0d:1697  
	Running time: 60 seconds
	!PASS: No errors detected in lsalr_6 on IPv6. Completed 13 iterations
      $

REFERENCES 

      ls(1), ssh(1), hosts(4)
