Stress Test: spray_6

### 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_6` produces output that details the packet loss and rate of transmission.

### DURATION

> 24 hours

### POSSIBLE CONCURRENT TESTS

> This test can run 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_6` 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)

Copyright 2005 Sun Microsystems, Inc. All rights reserved.