update
[netsniff-ng.git] / INSTALL
blob5426a6f6ae1bed605bc65c775b242ee19b9cab39
1 Currently only operating systems running on Linux kernels with
2 CONFIG_PACKET_MMAP enabled. This feature can be found even back
3 to the days of 2.4 kernels. Most operating systems ship pre-compiled
4 kernels that have this config option enabled and even the latest
5 kernel versions got rid of this option and have this functionality
6 already built-in. However, we recommend a kernel >= 2.6.31, because
7 the TX_RING is officially integrated since then.
9 netsniff-ng has been sucessfully tested on x86 and x86_64. Please drop
10 us a short mail, if it runs sucessfully on hardware other than that.
12 What libraries are required? You'll need libc, libncurses (only for ifpps),
13 nothing else. It is common, that these libraries are shipped as distribution
14 packages for an easy installation.
16 If you have arch x86 or x86_64, you can add -DARCH_X86 to the Makefiles
17 CFLAGS in order to exploit some x86-based CPU features (MMX/SSE*).
19 Also, you might want to adapt the IO Vector size in src/sg_pcap.c
20 (IOVSIZ) and in src/mmap_pcap.c (map_size) if you don't have enough RAM.
22 The installation process is fairly simple:
24   $ cd netsniff-ng/src/<tool>/
25   $ make deploy
26   # make install
28  where <tool> := { netsniff-ng, ifpps, trafgen, curvetun }
30 Note that by only typing 'make' the binaries are built without optimiztion
31 (-O0), so for productive usage, always build with 'make deploy'!
33 The uninstallation process is analogous:
35   $ cd netsniff-ng/src/<tool>/
36   # make uninstall
37   $ make clean