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.rst
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. CIDR (e.g. 198.18.0.0/15) is also allowed
22  -m : ($DST_MAC)   destination MAC-addr
23  -p : ($DST_PORT)  destination PORT range (e.g. 433-444) is also allowed
24  -t : ($THREADS)   threads to start
25  -f : ($F_THREAD)  index of first thread (zero indexed CPU number)
26  -c : ($SKB_CLONE) SKB clones send before alloc new SKB
27  -n : ($COUNT)     num messages to send per thread, 0 means indefinitely
28  -b : ($BURST)     HW level bursting of SKBs
29  -v : ($VERBOSE)   verbose
30  -x : ($DEBUG)     debug
31
32The global variable being set is also listed.  E.g. the required
33interface/device parameter "-i" sets variable $DEV.
34
35Common functions
36----------------
37The functions.sh file provides; Three different shell functions for
38configuring the different components of pktgen: pg_ctrl(), pg_thread()
39and pg_set().
40
41These functions correspond to pktgens different components.
42 * pg_ctrl()   control "pgctrl" (/proc/net/pktgen/pgctrl)
43 * pg_thread() control the kernel threads and binding to devices
44 * pg_set()    control setup of individual devices
45
46See sample scripts for usage examples.
47