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

TEST NAME 

      spray_6 - use RPC to send one-way stream of packets to host on IPv6

SYNOPSIS 

      ksh spray_6.sh REMOTE

DESCRIPTION 

      spray_6 uses RPC to send a one-way stream of packets to the host, and
      reports the number received and the transfer rate.

OPERANDS 

      REMOTE   Either a host name or IPv6 address of a machine to which 
               files and directories are copied. If a host name is 
               specified, the host name 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.

SETUP 

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

OUTPUT 

      As each set of 50,000 packets is transmitted, spray produces output
      detailing the packet loss and rate of transmission.

DURATION 

      24 hours

POSSIBLE CONCURRENT TESTS 

      You can run this test concurrently with cl3se3_6, lsalr_6, mpflip, ftpstress_6,
      and scp_6.

CAVEATS 

      * The spray_6 test uses unreliable connectionless transports (UDP).

      * Spray_6 can report a large number of packets dropped when the drops were
        caused by spray's sending packets faster than they can be buffered
        locally (before the packets get to the network medium).

EXAMPLES 

      # RUNTIME=1800
      # export RUNTIME
      # ./spray_6.sh harvey240
      Running time: 1800 seconds
      sending 50000 packets of length 8192 to harvey240 ...
              100 packets (0.200%) dropped by harvey240
              145 packets/sec, 1194721 bytes/sec
      sending 50000 packets of length 8192 to harvey240 ...
              41 packets (0.082%) dropped by harvey240
              146 packets/sec, 1200000 bytes/sec
      sending 50000 packets of length 8192 to harvey240 ...
              52 packets (0.104%) dropped by harvey240
              146 packets/sec, 1199743 bytes/sec
      sending 50000 packets of length 8192 to harvey240 ...
              105 packets (0.210%) dropped by harvey240
              146 packets/sec, 1198396 bytes/sec
      sending 50000 packets of length 8192 to harvey240 ...
              55 packets (0.110%) dropped by harvey240
              146 packets/sec, 1199550 bytes/sec
      sending 50000 packets of length 8192 to harvey240 ...
              541 packets (1.082%) dropped by harvey240
              146 packets/sec, 1199254 bytes/sec
      !PASS: Spray_6 completed
      #

REFERENCES 

      spray(1M), hosts(4), udp(7P)
