NAME

       trafgen - a high-performance zero-copy network packet generator

SYNOPSIS

       trafgen   [-d|--dev <netdev>][-c|--conf <file>][-J|--jumbo-support]
            [-x|--interactive][-n|--num <uint>][-r|--rand][-t|--gap <usec>]      [-S|--ring-size
       <size>][-k|--kernel-pull <usec>][-b|--bind-cpu <cpu>]      [-B|--unbind-cpu
       <cpu>][-H|--prio-high][-Q|--notouch-irq][-v|--version]      [-h|--help]

DESCRIPTION

       A high-performance network traffic generator that uses the zero-copy TX_RING for network
       I/O. For instance, on comodity Gigabit hardware up to 1,488,095 pps 64 Byte pps have been
       achieved with trafgen.

OPTIONS

       trafgen --dev eth0 --conf trafgen.txf --bind-cpu 0
           Use packet configuration trafgen.txf, eth0 as transmission device and CPU0 for binding
           the process.

OPTIONS

       -h|--help
           Print help text and lists all options.

       -v|--version
           Print version.

       -d|--dev <netdev>
           Device for transmission i.e., eth0.

       -c|--conf <conf>
           Path to packet configuration file.

       -x|--interactive
           Start trafgen in interactive mode.

       -J|--jumbo-support
           Support for 64KB Super Jumbo Frames

       -n|--num <uint>
           Number of packets to generate before exiting.  0 means forever until SIGINT.

       -r|--rand
           Randomize packet selection process instead of round-robin.

       -t|--gap <uint>
           Interpacket gap in microseconds.

       -S|--ring-size <size>
           Manually set ring size to <size>: mmap space in KB/MB/GB.

       -k|--kernel-pull <uint>
           Kernel pull from user interval in microseconds.  Default value is 10 microseconds.

       -b|--bind-cpu <cpu>
           Bind to specific CPU (or CPU-range).

       -B|--unbind-cpu <cpu>
           Forbid to use specific CPU (or CPU-range).

       -H|--prio-high
           Make this high priority process.

       -Q|--notouch-irq
           Do not touch IRQ CPU affinity of NIC.

EXAMPLES

       Generate traffic defined in trafgen.txf on eth0 using CPU 0
           trafgen --dev eth0 --conf trafgen.txf --bind-cpu 0

       Generate traffic on eth0 using CPU 0, wait 100 us between packets
           trafgen --dev eth0 --conf trafgen.txf --bind-cpu 0 --gap 100

       Generate 100,000 packet on eth0 using CPU 0
           trafgen --dev eth0 --conf trafgen.txf --bind-cpu 0 --num 100000

AUTHOR

       Written by Daniel Borkmann <daniel@netsniff-ng.org>

DOCUMENTATION

       Documentation by Emmanuel Roullit <emmanuel@netsniff-ng.org>

BUGS

       Please report bugs to <bugs@netsniff-ng.org>

                                            2012-06-29                                 trafgen(8)