efbu.1
Author: cmaier@cmassoc.net

    efbu(1)                                      Qualcomm Atheros Open Powerline Toolkit                                     efbu(1)

    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,  hexadeci‐
                  mal 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 sec‐
                  ond 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 <cmaier@qca.qualcomm.com>

    open-plc-utils-0.0.3                                        Mar 2014                                                     efbu(1)

[PREV] [HOME] [NEXT]