d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Obtained from: NetBSD

Browse Source 
imported the spray command from NetBSD - it can be used for network
analysis (see the man-page)
This commit is contained in:
Thomas Graichen 1996-01-05 09:09:30 +00:00
parent 968a1b9ae4
commit d021b6c07a
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/vendor/NetBSD/dist/; revision=13242
3 changed files with 307 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
usr.sbin/spray/Makefile Normal file
View File

@ -0,0 +1,7 @@
# $Id: Makefile,v 1.2 1995/07/11 01:18:05 jtc Exp $
PROG= spray
MAN8= spray.8
LDADD= -lrpcsvc
.include <bsd.prog.mk>

76
usr.sbin/spray/spray.8 Normal file
View File

@ -0,0 +1,76 @@
.\"
.\" Copyright (c) 1994 James A. Jegers
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. The name of the author may not be used to endorse or promote products
.\" derived from this software without specific prior written permission
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd July 10, 1995
.Dt SPRAY 8
.Os FreeBSD
.Sh NAME
.Nm spray
.Nd send many packets to host
.Sh SYNOPSIS
.Nm spray
.Op Fl c Ar count
.Op Fl d Ar delay
.Op Fl l Ar length
.Ar host
\&...
.Ek
.Sh DESCRIPTION
.Nm Spray
sends multiple RPC packets to
.Ar host
and records how many of them were correctly received and how long it took.
.Pp
The options are as follows:
.Bl -tag -width indent
.It Fl c Ar count
Send
.Ar count
packets.
.It Fl d Ar delay
Pause
.Ar delay
microseconds between sending each packet.
.It Fl l Ar length
Set the length of the packet that holds the RPC call message to
.Ar length
bytes.
Not all values of
.Ar length
are possible because RPC data is encoded using XDR.
.Nm Spray
rounds up to the nearest possible value.
.El
.Pp
.Nm Spray
is intended for use in network testing, measurement, and management.
This command
.Bf -emphasis
can be very hard on a network and should be used with caution.
.Ef
.Pp
.Sh SEE ALSO
.Xr netstat 1 ,
.Xr ifconfig 8 ,
.Xr ping 8 ,
.Xr rpc.sprayd 8

224
usr.sbin/spray/spray.c Normal file
View File

@ -0,0 +1,224 @@
/*
* Copyright (c) 1993 Winning Strategies, Inc.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. All advertising materials mentioning features or use of this software
* must display the following acknowledgement:
* This product includes software developed by Winning Strategies, Inc.
* 4. The name of the author may not be used to endorse or promote products
* derived from this software without specific prior written permission
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* $Id: spray.c,v 1.3 1994/12/23 16:42:47 cgd Exp $
*/
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <rpc/rpc.h>
#include <rpcsvc/spray.h>
#ifndef SPRAYOVERHEAD
#define SPRAYOVERHEAD 86
#endif
void usage ();
void print_xferstats ();
/* spray buffer */
char spray_buffer[SPRAYMAX];
/* RPC timeouts */
struct timeval NO_DEFAULT = { -1, -1 };
struct timeval ONE_WAY = { 0, 0 };
struct timeval TIMEOUT = { 25, 0 };
int
main(argc, argv)
int argc;
char **argv;
{
char *progname;
spraycumul host_stats;
sprayarr host_array;
CLIENT *cl;
int c;
int i;
int count = 0;
int delay = 0;
int length = 0;
double xmit_time; /* time to receive data */
progname = *argv;
while ((c = getopt(argc, argv, "c:d:l:")) != -1) {
switch (c) {
case 'c':
count = atoi(optarg);
break;
case 'd':
delay = atoi(optarg);
break;
case 'l':
length = atoi(optarg);
break;
default:
usage();
/* NOTREACHED */
}
}
argc -= optind;
argv += optind;
if (argc != 1) {
usage();
/* NOTREACHED */
}
/* Correct packet length. */
if (length > SPRAYMAX) {
length = SPRAYMAX;
} else if (length < SPRAYOVERHEAD) {
length = SPRAYOVERHEAD;
} else {
/* The RPC portion of the packet is a multiple of 32 bits. */
length -= SPRAYOVERHEAD - 3;
length &= ~3;
length += SPRAYOVERHEAD;
}
/*
* The default value of count is the number of packets required
* to make the total stream size 100000 bytes.
*/
if (!count) {
count = 100000 / length;
}
/* Initialize spray argument */
host_array.sprayarr_len = length - SPRAYOVERHEAD;
host_array.sprayarr_val = spray_buffer;
/* create connection with server */
cl = clnt_create(*argv, SPRAYPROG, SPRAYVERS, "udp");
if (cl == NULL) {
clnt_pcreateerror(progname);
exit(1);
}
/*
* For some strange reason, RPC 4.0 sets the default timeout,
* thus timeouts specified in clnt_call() are always ignored.
*
* The following (undocumented) hack resets the internal state
* of the client handle.
*/
clnt_control(cl, CLSET_TIMEOUT, (caddr_t)&NO_DEFAULT);
/* Clear server statistics */
if (clnt_call(cl, SPRAYPROC_CLEAR, xdr_void, NULL, xdr_void, NULL, TIMEOUT) != RPC_SUCCESS) {
clnt_perror(cl, progname);
exit(1);
}
/* Spray server with packets */
printf ("sending %d packets of lnth %d to %s ...", count, length, *argv);
fflush (stdout);
for (i = 0; i < count; i++) {
clnt_call(cl, SPRAYPROC_SPRAY, xdr_sprayarr, &host_array, xdr_void, NULL, ONE_WAY);
if (delay) {
usleep(delay);
}
}
/* Collect statistics from server */
if (clnt_call(cl, SPRAYPROC_GET, xdr_void, NULL, xdr_spraycumul, &host_stats, TIMEOUT) != RPC_SUCCESS) {
clnt_perror(cl, progname);
exit(1);
}
xmit_time = host_stats.clock.sec +
(host_stats.clock.usec / 1000000.0);
printf ("\n\tin %.2f seconds elapsed time\n", xmit_time);
/* report dropped packets */
if (host_stats.counter != count) {
int packets_dropped = count - host_stats.counter;
printf("\t%d packets (%.2f%%) dropped\n",
packets_dropped,
100.0 * packets_dropped / count );
} else {
printf("\tno packets dropped\n");
}
printf("Sent:");
print_xferstats(count, length, xmit_time);
printf("Rcvd:");
print_xferstats(host_stats.counter, length, xmit_time);
exit (0);
}
void
print_xferstats(packets, packetlen, xfertime)
int packets;
int packetlen;
double xfertime;
{
int datalen;
double pps; /* packets per second */
double bps; /* bytes per second */
datalen = packets * packetlen;
pps = packets / xfertime;
bps = datalen / xfertime;
printf("\t%.0f packets/sec, ", pps);
if (bps >= 1024)
printf ("%.1fK ", bps / 1024);
else
printf ("%.0f ", bps);
printf("bytes/sec\n");
}
void
usage ()
{
fprintf(stderr, "usage: spray [-c count] [-l length] [-d delay] host\n");
exit(1);
}