Merge branch 'fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/evalenti/linux...
[linux/fpc-iii.git] / samples / pktgen / README.rst
blob8365c4e5c513e4a000175b54cf284f299e84cff8
1 Sample and benchmark scripts for pktgen (packet generator)
2 ==========================================================
3 This directory contains some pktgen sample and benchmark scripts, that
4 can easily be copied and adjusted for your own use-case.
6 General doc is located in kernel: Documentation/networking/pktgen.txt
8 Helper include files
9 ====================
10 This directory contains two helper shell files, that can be "included"
11 by shell source'ing.  Namely "functions.sh" and "parameters.sh".
13 Common parameters
14 -----------------
15 The parameters.sh file support easy and consistant parameter parsing
16 across the sample scripts.  Usage example is printed on errors::
18  Usage: ./pktgen_sample01_simple.sh [-vx] -i ethX
19   -i : ($DEV)       output interface/device (required)
20   -s : ($PKT_SIZE)  packet size
21   -d : ($DEST_IP)   destination IP
22   -m : ($DST_MAC)   destination MAC-addr
23   -t : ($THREADS)   threads to start
24   -c : ($SKB_CLONE) SKB clones send before alloc new SKB
25   -b : ($BURST)     HW level bursting of SKBs
26   -v : ($VERBOSE)   verbose
27   -x : ($DEBUG)     debug
29 The global variable being set is also listed.  E.g. the required
30 interface/device parameter "-i" sets variable $DEV.
32 Common functions
33 ----------------
34 The functions.sh file provides; Three different shell functions for
35 configuring the different components of pktgen: pg_ctrl(), pg_thread()
36 and pg_set().
38 These functions correspond to pktgens different components.
39  * pg_ctrl()   control "pgctrl" (/proc/net/pktgen/pgctrl)
40  * pg_thread() control the kernel threads and binding to devices
41  * pg_set()    control setup of individual devices
43 See sample scripts for usage examples.