Provided by: plc-utils-extra_0.0.6+git20230504.1ba7d5a0-1_amd64 bug

NAME

       efbu - Ethernet Frame Blast Utility

SYNOPSIS

       efbu [options]

DESCRIPTION

       Send  IP  broadcast  frames of maximum length at maximum rate over a given interface for a
       given period in seconds.   The  maximum  frame  length  is  ETHER_MAX_LEN  as  defined  in
       <net/ethernet.h>.   The  maximum rate is limited by the host processor type, the number of
       active processes, the interface hardware and so on.  This program does  the  best  it  can
       within  the  given execution environment.  Multi-processosr and faster hosts should see at
       least 85mb.  Single-processor and slower hosts will see less.

       This program is for test purposes.  It has no practical application  beyond  flooding  the
       network with useless traffic and annoying the network administrator.  Don't abuse it.

OPTIONS

       -b value
              Byte  value  used to pad Ethernet frames. Valid values are 0 through 255 and may be
              specified in decimal, hexadecimal or  binary.  Hexadecimal  is  prefixed  with  0x.
              Binary is prefixed with 0b. The default is 0xAA or 0b10101010.

       -d address
              Replace  the destination Ethernet address of each transmitted frame with the option
              argument. The destination address consists of 12 hex  digits  in  upper,  lower  or
              mixed  case.  Octets  may  be  seperated with colons for clarity but colons are not
              required.

       -e ethertype
              The ethertype expressed as a 16-bit hexadecimal integer. Prefix "0x"  is  optional.
              The default is ETH_P_802_2 as defined in if_ether.h.

       -h     Replace  the  source address of each transmitted frame with the Ethernet address of
              the host interface used to send the frame. This allows frames to be sent  correctly
              from any host interface. Use option -i to specify an interface.

       -i interface
              The  host  interface used to send frames. The default is "eth1" because most people
              use "eth0" as their principle network connection; however, if the string  "PLC"  is
              defined  in  the  environment  then  it  will  over-ride  the  program default. Any
              interface specified on the command line will over-ride the default.

       -p milliseconds
              The pause time in milliseconds.  The program pause this  long  after  sending  each
              frame.   If  0  then the network will be flooded with frames for the duration.  The
              default is 50 milliseconds which results in about 20  frames  per  second  for  the
              duration.  Permitted values are 0 through UINT_MAX as defined in <limits.h>.

       -t milliseconds
              The blast duration in milliseconds.  The default is 1000 milliseconds seconds which
              is about 1  second.   Permitted  values  are  0  through  UINT_MAX  as  defined  in
              <limits.h>.

       -v     Print  transmitted  frames  in  hex  dump  format  on stdout as they are sent. This
              reduces network transmission rate, as a consequence.

ARGUMENTS

       None.

EXAMPLES

       The following example sends an IP broadcast frame of maximum length on host interface eth2
       for  a  duration  of  20  seconds.  The destination address will be the Ethernet broadcast
       address because option -d is omitted.  The  source  address  will  be  the  host  Ethernet
       interface address because option -h is present. Frames will be send at about 20 frames per
       second because option -p is not present.

          # efbu -ieth2 -t20000 -h -e0800

       The outgoing frame will look something like this when captured with wireshark.

          00000000 FF FF FF FF FF FF 00 50 04 D3 4E F2 08 00 AA AA .......P..N.....
          00000010 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000020 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000030 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000040 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000050 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000060 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000070 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000080 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000090 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000000A0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000000B0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000000C0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000000D0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000000E0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000000F0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000100 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000110 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000120 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000130 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000140 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000150 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000160 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000170 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000180 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000190 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000001A0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000001B0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000001C0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000001D0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000001E0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000001F0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000200 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000210 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000220 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000230 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000240 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000250 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000260 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000270 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000280 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000290 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000002A0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000002B0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000002C0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000002D0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000002E0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000002F0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000300 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000310 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000320 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000330 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000340 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000350 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000360 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000370 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000380 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000390 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000003A0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000003B0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000003C0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000003D0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000003E0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000003F0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000400 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000410 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000420 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000430 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000440 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000450 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000460 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000470 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000480 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000490 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000004A0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000004B0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000004C0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000004D0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000004E0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000004F0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000500 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000510 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000520 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000530 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000540 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000550 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000560 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000570 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000580 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          00000590 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000005A0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000005B0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000005C0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000005D0 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA ................
          000005E0 AA AA AA AA AA AA AA AA AA AA                   ..........

SEE ALSO

       amp(1), efsu(1), hpav(1)

CREDITS

        Charles Maier