Subsections

1 Before You Start

1 Overview

1.1 Corrections and additions to the manual

I've tried to keep this document up to date with the changes in tcpreplay, but occasionally I get too busy, make a mistake or just forget something. If you find anything in this document which could be improved upon, please let me know.

1.2 Getting Help

If you still have a question after reading the Tcpreplay manual and FAQ, please contact the Tcpreplay-Users <tcpreplay-users@lists.sourceforge.net> mailing list. Note that if you ask a question which has clearly been covered in either the manual or FAQ, you will most likely be told to RTFM.

1.3 What tools come with tcpreplay?

1.4 What tools no longer come with tcpreplay?

Recently, other people and projects have developed better versions of two applications that ship with tcpreplay 2.x:

2 Getting Tcpreplay working on your system

2.1 How can I get tcpreplay's source?

The source code is available in tarball format on the tcpreplay homepage: http://tcpreplay.sourceforge.net/ I also encourage users familiar with Subversion to try checking out the latest code as it often has additional features and bugfixes not found in the tarballs.

svn checkout https://www.synfin.net:444/svn/tcpreplay/trunk tcpreplay-3

2.2 OS X and Debian users

There are OS X and Debian packages available via Fink and APT respectively. Both packages are maintained by other people and occasionally are out of date with the latest source code release.

2.3 What requirements does tcpreplay have?

  1. Libnet2 1.1.x or better (1.1.3 fixes a checksum bug)
  2. Libpcap3 0.6.x or better (0.8.3 or better recommended)
  3. To support the packet decoding feature you'll need tcpdump4 installed.
  4. You'll also need a compatible operating system. Basically, any *NIX operating system should work. Linux, *BSD, Solaris, OS X and others should all work. If you find any compatibility issues with any *NIX OS, please let me know.

2.4 How do I compile tcpreplay?

Two easy steps:

  1. As a normal user: ./configure && make
  2. As root: make install
There are some optional arguments which can be passed to the 'configure' script which may help in cases where your libnet, libpcap or tcpdump installation is not standard or if it can't determine the correct network interface card to use for testing. If you find that configure isn't completing correctly, run: ./configure -help for more information.

You may also choose to run 'make test -i' as root:



Footnotes

... flowreplay1
Flowreplay is still ``alpha'' quality and is not usable for most situations. Anyone interested in helping me develop flowreplay is encouraged to contact me.
... Libnet2
http://www.packetfactory.net/libnet/
... Libpcap3
http://www.tcpdump.org/
... tcpdump4
http://www.tcpdump.org/
Aaron Turner 2005-02-27