table of contents
other versions
- wheezy 3.4.3-2+wheezy1
- jessie 3.4.4-2+deb8u1
- testing 3.4.4-3
- unstable 4.2.5-1
- experimental 4.2.6-1~exp1
TCPREPLAY(1) | Programmer's Manual | TCPREPLAY(1) |
NAME¶
tcpreplay - Replay network traffic stored in pcap filesSYNOPSIS¶
tcpreplay [-flag [value]]... [--opt-name [[=| ]value]]...<pcap_file(s)> tcpreplay is a tool for replaying network traffic from files saved with tcpdump or other tools which write pcap(3) files.
DESCRIPTION¶
This manual page briefly documents the tcpreplay command. The basic operation of tcpreplay is to resend all packets from the input file(s) at the speed at which they were recorded, or a specified data rate, up to as fast as the hardware is capable.OPTIONS¶
- -d number, --dbug=number
- Enable debugging output. This option may appear up to 1
times. This option takes an integer number as its argument. The value of
number is constrained to being:
in the range 0 through 5
The default number for this option is:
0
- -q, --quiet
- Quiet mode.
- -T string, --timer=string
- Select packet timing mode: select, ioport, rdtsc, gtod,
nano, abstime. This option may appear up to 1 times. The default
string for this option is:
gtod
- --sleep-accel=number
- Reduce the amount of time to sleep by specified usec. This
option takes an integer number as its argument. The default number
for this option is:
0
- --rdtsc-clicks=number
- Specify the RDTSC clicks/usec. This option may appear up to
1 times. This option takes an integer number as its argument. The default
number for this option is:
0
- -v, --verbose
- Print decoded packets via tcpdump to STDOUT. This option
may appear up to 1 times.
- -A string, --decode=string
- Arguments passed to tcpdump decoder. This option may appear
up to 1 times. This option must appear in combination with the following
options: verbose.
- -K, --enable-file-cache
- Enable caching of packets to internal memory. This option
must appear in combination with the following options: loop.
- -c string, --cachefile=string
- Split traffic via a tcpprep cache file. This option may
appear up to 1 times.
- -i string, --intf1=string
- Server/primary traffic output interface. This option may
appear up to 1 times.
- -I string, --intf2=string
- Client/secondary traffic output interface. This option may
appear up to 1 times. This option must appear in combination with the
following options: cachefile.
- --listnics
- List available network interfaces and exit.
- -l number, --loop=number
- Loop through the capture file X times. This option may
appear up to 1 times. This option takes an integer number as its argument.
The value of number is constrained to being:
greater than or equal to 0
The default number for this option is:
1
- --pktlen
- Override the snaplen and use the actual packet len. This
option may appear up to 1 times.
- -L number, --limit=number
- Limit the number of packets to send. This option may appear
up to 1 times. This option takes an integer number as its argument. The
value of number is constrained to being:
greater than or equal to 1
The default number for this option is:
-1
- -x string, --multiplier=string
- Modify replay speed to a given multiple. This option may
appear up to 1 times. This option must not appear in combination with any
of the following options: pps, mbps, oneatatime, topspeed.
2.0 will replay traffic at twice the speed captured 0.7 will replay traffic at 70% the speed captured
- -p number, --pps=number
- Replay packets at a given packets/sec. This option may
appear up to 1 times. This option must not appear in combination with any
of the following options: multiplier, mbps, oneatatime, topspeed. This
option takes an integer number as its argument.
- -M string, --mbps=string
- Replay packets at a given Mbps. This option may appear up
to 1 times. This option must not appear in combination with any of the
following options: multiplier, pps, oneatatime, topspeed.
- -t, --topspeed
- Replay packets as fast as possible. This option must not
appear in combination with any of the following options: mbps, multiplier,
pps, oneatatime.
- -o, --oneatatime
- Replay one packet at a time for each user input. This
option must not appear in combination with any of the following options:
mbps, pps, multiplier, topspeed.
- --pps-multi=number
- Number of packets to send for each time interval. This
option must appear in combination with the following options: pps. This
option takes an integer number as its argument. The value of number
is constrained to being:
greater than or equal to 1
The default number for this option is:
1
- -P, --pid
- Print the PID of tcpreplay at startup.
- -V, --version
- Print version information.
- -h, --less-help
- Display less usage information and exit.
- -H, --help
- Display usage information and exit.
- -!, --more-help
- Extended usage information passed thru pager.
- - [rcfile], --save-opts[=rcfile]
- Save the option state to rcfile. The default is the last configuration file listed in the OPTION PRESETS section, below.
- - rcfile, --load-opts=rcfile, --no-load-opts
- Load options from rcfile. The no-load-opts form will disable the loading of earlier RC/INI files. --no-load-opts is handled early, out of order.
OPTION PRESETS¶
Any option that is not marked as not presettable may be preset by loading values from configuration ("RC" or ".INI") file(s). The homerc file is "$$/", unless that is a directory. In that case, the file " .tcpreplayrc" is searched for within that directory.SIGNALS¶
tcpreplay understands the following signals:SEE ALSO¶
tcpreplay-edit(1), tcpdump(1), tcpprep(1), tcprewrite(1), libnet(3)BUGS¶
tcpreplay can only send packets as fast as your computer's interface, processor, disk and system bus will allow.AUTHOR¶
Copyright 2000-2008 Aaron Turner2009-06-25 | (tcpreplay ) |