Stress Test: spray

### TEST NAME

> spray - use RPC to send one-way stream of packets to host

### SYNOPSIS

> `ksh spray.sh` remote

### DESCRIPTION

> `spray` 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 IP address of a machine to which files and directories are copied. If a host name is specified, the host name must appear in `/etc/hosts` along with the remote machine's IP 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 that details the packet loss and rate of transmission.

### DURATION

> 24 hours

### POSSIBLE CONCURRENT TESTS

> This test can run concurrently with `cl3se3`, `lsalr`, `mpflip`, `ftpstress`, and `scp`.

### CAVEATS

> - The `spray` test uses unreliable connectionless transports (UDP).

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

### EXAMPLES

> >     # RUNTIME=1800 export RUNTIME
> >     # ./spray.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 completed

### REFERENCES

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

Copyright 2005 Sun Microsystems, Inc. All rights reserved.