From bdfd22ceea4ba6dba113b1ac8514abb2839b94e4 Mon Sep 17 00:00:00 2001 From: Daniel Borkmann Date: Tue, 30 Apr 2013 17:49:22 +0200 Subject: man: trafgen: finish trafgen manpage Finish the last part, which is usage examples. Signed-off-by: Daniel Borkmann --- man/trafgen.8 | 41 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) diff --git a/man/trafgen.8 b/man/trafgen.8 index aa91d97..6ead20c 100644 --- a/man/trafgen.8 +++ b/man/trafgen.8 @@ -327,7 +327,46 @@ Another real-world example by Jesper Dangaard Brouer [1]: [1] http://thread.gmane.org/gmane.linux.network/257155 .SH USAGE EXAMPLE -TODO + +.SS trafgen --dev eth0 --conf trafgen.cfg +This is the most simple and probably also most used command for trafgen. It +will generate traffic defined in the configuration file ``trafgen.cfg'' and +transmit this via the ``eth0'' networking device. All online CPUs are used. + +.SS trafgen -e | trafgen -i - -o lo --cpp -n 1 +This is an example where we send one packet of the built-in example through +the loopback device. The example configuration is passed via stdin and also +through the C preprocessor before trafgen's packet compiler will see it. + +.SS trafgen --dev eth0 --conf fuzzing.cfg --smoke-test 10.0.0.1 +Read the ``fuzzing.cfg'' packet configuration file (which contains drnd() +calls) and send out the generated packets to the ``eth0'' device. After each +sent packet, ping probe the attacked host with address 10.0.0.1 to check if +it's still alive. This also means, that we utilize 1 CPU only, and do not +use the TX_RING, but sendto(2) packet I/O due to ``slow mode''. + +.SS trafgen --dev wlan0 --rfraw --conf beacon-test.txf -V --cpus 2 +As an output device ``wlan0'' is used and put into monitoring mode, thus we +are going to transmit raw 802.11 frames through the air. Use the +``beacon-test.txf'' configuration file, set trafgen into verbose mode and +use only 2 CPUs. + +.SS trafgen --dev em1 --conf frag_dos.cfg --rand --gap 1000 +Use trafgen in sendto(2) mode instead of TX_RING mode and sleep after each +sent packet a static timegap for 1000us. Generate packets from ``frag_dos.cfg'' +and select next packets to send randomly instead of a round-robin fashion. +The output device for packets is ``em1''. + +.SS trafgen --dev eth0 --conf icmp.cfg --rand --num 1400000 -k1000 +Send only 1400000 packets using the ``icmp.cfg'' configuration file and then +exit trafgen. Select packets randomly from that file for transmission and +send them out via ``eth0''. Also, trigger the kernel every 1000us for batching +the ring frames from user space (default is 10us). + +.SS trafgen --dev eth0 --conf tcp_syn.cfg -u `id -u bob` -g `id -g bob` +Send out packets generated from the configuration file ``tcp_syn.cfg'' via +the ``eth0'' networking device. After setting up the ring for transmission, +drop credentials to the non-root user/group bob/bob. .SH NOTE trafgen can saturate a Gigabit Ethernet link without problems. As always, -- cgit v1.2.3-54-g00ecf