usr.sbin/spray/spray.8

   1 .\"
   2 .\" Copyright (c) 1994 James A. Jegers
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. The name of the author may not be used to endorse or promote products
  11 .\"    derived from this software without specific prior written permission
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  14 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  15 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  16 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  17 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  18 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  19 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  20 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  21 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  22 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  23 .\"
  24 .\" $FreeBSD$
  25 .\"
  26 .Dd July 10, 1995
  27 .Dt SPRAY 8
  28 .Os
  29 .Sh NAME
  30 .Nm spray
  31 .Nd send many packets to host
  32 .Sh SYNOPSIS
  33 .Nm
  34 .Op Fl c Ar count
  35 .Op Fl d Ar delay
  36 .Op Fl l Ar length
  37 .Ar host
  38 .Sh DESCRIPTION
  39 The
  40 .Nm
  41 utility sends multiple RPC packets to
  42 .Ar host
  43 and records how many of them were correctly received and how long it took.
  44 .Pp
  45 The options are as follows:
  46 .Bl -tag -width indent
  47 .It Fl c Ar count
  48 Send
  49 .Ar count
  50 packets.
  51 .It Fl d Ar delay
  52 Pause
  53 .Ar delay
  54 microseconds between sending each packet.
  55 .It Fl l Ar length
  56 Set the length of the packet that holds the RPC call message to
  57 .Ar length
  58 bytes.
  59 Not all values of
  60 .Ar length
  61 are possible because RPC data is encoded using XDR.
  62 The
  63 .Nm
  64 utility rounds up to the nearest possible value.
  65 .El
  66 .Pp
  67 The
  68 .Nm
  69 utility is intended for use in network testing, measurement, and management.
  70 This command
  71 .Em "can be very hard on a network and should be used with caution" .
  72 .Sh SEE ALSO
  73 .Xr netstat 1 ,
  74 .Xr ifconfig 8 ,
  75 .Xr ping 8 ,
  76 .Xr rpc.sprayd 8