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