spray(3n) [hpux man page]

spray(3N)																 spray(3N)

NAME

       spray - scatter data in order to check the network

SYNOPSIS

DESCRIPTION

       This  reference	page describes the data structures and XDR routines used by the spray(1M) program.  A function call does not exist.  Refer
       to spray(1M) for more information.

   RPC Information
       Program number:

       XDR routines:

	      xdr_sprayarr(xdrs, arr);
		      XDR *xdrs;
		      struct sprayarr *arr;
	      xdr_spraycumul(xdrs, cumul);
		      XDR *xdrs;
		      struct spraycumul *cumul;

       Procedures:

	      Takes no arguments, returns no value.
		     Increments a counter in server daemon.  The server does not return this call, so the caller should have a timeout of 0.   The
		     sprayarr is only used by the caller, to vary the size of the UDP packets sent.

	      Takes no arguments, returns
		     struct  spraycumul  with  the values of counter and clock set to reflect the number of calls, and the total time (seconds and
		     microseconds) elapsed since the last request.

	      Takes no arguments and returns no value.
		     Zeros out counter and clock in preparation for calls to

       Versions:

       Structures:

	      struct spraycumul {
		      unsigned counter;
		      struct timeval clock;
	      };
	      struct sprayarr {
		      int *data;
		      int lnth;
	      };

WARNINGS

       User applications that call this routine must be linked with For example,

AUTHOR

       was developed by Sun Microsystems, Inc.

SEE ALSO

       spray(1M), sprayd(1M).

																	 spray(3N)

spray(1M)						  System Administration Commands						 spray(1M)

NAME

       spray - spray packets

SYNOPSIS

       /usr/sbin/spray [-c count] [-d delay] [-l length]
	    [-t nettype] host

DESCRIPTION

       spray sends a one-way stream of packets to host using RPC, and reports how many were received, as well as the transfer rate. The host argu-
       ment can be either a name or an Internet address.

       spray is not useful as a networking benchmark, as it uses unreliable connectionless transports, UDP for example. 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, that is, before the
       packets get to the network medium.

OPTIONS

       -c count      Specify how many packets to send. The default value of count is the number of packets required to make the total stream  size
		     100000 bytes.

       -d delay      Specify how many microseconds to pause between sending each packet. The default is 0.

       -l length     The  length  parameter  is  the  numbers  of  bytes in the Ethernet packet that holds the RPC call message. Since the data is
		     encoded using XDR, and XDR only deals with 32 bit quantities, not all values of length are possible, and spray rounds  up	to
		     the nearest possible value. When length is greater than 1514, then the RPC call can no longer be encapsulated in one Ethernet
		     packet, so the length field no longer has a simple correspondence to Ethernet packet size. The default value of length is	86
		     bytes, the size of the RPC and UDP headers.

       -t nettype    Specify class of transports. Defaults to  netpath. See rpc(3NSL) for a description of supported classes.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWrcmdc 		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       rpc(3NSL), attributes(5)

SunOS 5.11							    6 Nov 2000								 spray(1M)