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 accessible 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. Max
imal amount for linux-2.4 is 6. Far not all the
devices support fragmented buffers.
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.
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 sat
urates 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-routing/iputils-current.tar.gz.
iputils-020927 27 September 2002 PG3(8)
Man(1) output converted with
man2html