README.rst
1Sample and benchmark scripts for pktgen (packet generator)
2==========================================================
3This directory contains some pktgen sample and benchmark scripts, that
4can easily be copied and adjusted for your own use-case.
5
6General doc is located in kernel: Documentation/networking/pktgen.txt
7
8Helper include files
9====================
10This directory contains two helper shell files, that can be "included"
11by shell source'ing. Namely "functions.sh" and "parameters.sh".
12
13Common parameters
14-----------------
15The parameters.sh file support easy and consistant parameter parsing
16across the sample scripts. Usage example is printed on errors::
17
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 -f : ($F_THREAD) index of first thread (zero indexed CPU number)
25 -c : ($SKB_CLONE) SKB clones send before alloc new SKB
26 -n : ($COUNT) num messages to send per thread, 0 means indefinitely
27 -b : ($BURST) HW level bursting of SKBs
28 -v : ($VERBOSE) verbose
29 -x : ($DEBUG) debug
30
31The global variable being set is also listed. E.g. the required
32interface/device parameter "-i" sets variable $DEV.
33
34Common functions
35----------------
36The functions.sh file provides; Three different shell functions for
37configuring the different components of pktgen: pg_ctrl(), pg_thread()
38and pg_set().
39
40These functions correspond to pktgens different components.
41 * pg_ctrl() control "pgctrl" (/proc/net/pktgen/pgctrl)
42 * pg_thread() control the kernel threads and binding to devices
43 * pg_set() control setup of individual devices
44
45See sample scripts for usage examples.
46
