Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pg3(8) [suse man page]

PG3(8)							 System Manager's Manual: iputils						    PG3(8)

NAME

       pg3, ipg, pgset - send stream of UDP packets

SYNOPSIS

       source ipg

       pg

       pgset COMMAND

DESCRIPTION

       ipg  is not a program, it is script which should be sourced to bash. When sourced it loads module pg3 and exports a few of functions acces-
       sible from parent shell. These macros are pg to start packet injection and to get the results of run; and pgset to setup packet generator.

       pgset can send the following commands to module pg3:

COMMAND

       odev DEVICE
	      Name of Ethernet device to test. See warning below.

       pkt_size BYTES
	      Size of packet to generate. The size includes all the headers: UDP, IP, MAC, but does not account for overhead internal  to  medium,
	      i.e. FCS and various paddings.

       frags NUMBER
	      Each  packet  will  contain NUMBER of fragments.	Maximal amount for linux-2.4 is 6. Far not all the devices support fragmented buf-
	      fers.

       count NUMBER
	      Send stream of NUMBER of packets and stop after this.

       ipg TIME
	      Introduce artificial delay between packets of TIME microseconds.

       dst IP_ADDRESS
	      Select IP destination where the stream is sent to.  Beware, never set this address at random. pg3 is not a toy,  it  creates  really
	      tough stream. Default value is 0.0.0.0.

       dst MAC_ADDRESS
	      Select  MAC  destination	where the stream is sent to.  Default value is 00:00:00:00:00:00 in hope that this will not be received by
	      any node on LAN.

       stop   Abort packet injection.

WARNING

       When output device is set to some random device different of hardware Ethernet device, pg3 will crash kernel.

       Do not use it on VLAN, ethertap, VTUN and other devices, which emulate Ethernet not being real Ethernet in fact.

AUTHOR

       pg3 was written by Robert Olsson <robert.olsson@its.uu.se>.

SECURITY

       This can be used only by superuser.

       This tool creates floods of packets which is unlikely to be handled even by high-end machines. For example, it saturates gigabit link  with
       60  byte  packets  when	used with Intel's e1000. In face of such stream switches, routers and end hosts may deadlock, crash, explode.  Use
       only in test lab environment.

AVAILABILITY

       pg3 is part of iputils package and the latest versions are   available  in  source  form  for  anonymous  ftp  ftp://ftp.inr.ac.ru/ip-rout-
       ing/iputils-current.tar.gz.

iputils-021109							  09 iINAON 2002							    PG3(8)

Check Out this Related Man Page

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)
Man Page