android_kernel_samsung_sm8650/samples/pktgen
Jesper Dangaard Brouer b64b0d1e64 pktgen: new pktgen helper functions for samples scripts
Preparing for removing existing samples/pktgen/ scripts, and
replacing these with easier to use samples.

This commit provides two helper shell files, that can
be "included" by shell source'ing. Namely "functions.sh"
and "parameters.sh".

The parameters.sh file support easy and consistant parameter
parsing across the sample scripts.  Usage example is printed on
errors.

The functions.sh file provides, three new shell functions for
configuring the different components of pktgen: pg_ctrl(),
pg_thread() and pg_set().  A slightly improved version of the old
pgset() function is also provided for backwards compat.

The new functions correspond to pktgens different components.
 * pg_ctrl()   control "pgctrl" (/proc/net/pktgen/pgctrl)
 * pg_thread() control the kernel threads and binding to devices
 * pg_set()    control setup of individual devices

These changes are borrowed from:
 https://github.com/netoptimizer/network-testing/tree/master/pktgen

Signed-off-by: Jesper Dangaard Brouer <brouer@redhat.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
2015-05-22 23:59:16 -04:00
..
functions.sh pktgen: new pktgen helper functions for samples scripts 2015-05-22 23:59:16 -04:00
parameters.sh pktgen: new pktgen helper functions for samples scripts 2015-05-22 23:59:16 -04:00
pktgen.conf-1-1 samples/pktgen: Show the results rather than just commenting where they are 2015-02-23 22:04:25 -05:00
pktgen.conf-1-1-flows samples/pktgen: Show the results rather than just commenting where they are 2015-02-23 22:04:25 -05:00
pktgen.conf-1-1-ip6 samples/pktgen: Show the results rather than just commenting where they are 2015-02-23 22:04:25 -05:00
pktgen.conf-1-1-ip6-rdos samples/pktgen: Show the results rather than just commenting where they are 2015-02-23 22:04:25 -05:00
pktgen.conf-1-1-rdos samples/pktgen: Show the results rather than just commenting where they are 2015-02-23 22:04:25 -05:00
pktgen.conf-1-2 samples/pktgen: Show the results rather than just commenting where they are 2015-02-23 22:04:25 -05:00
pktgen.conf-2-1 samples/pktgen: Show the results rather than just commenting where they are 2015-02-23 22:04:25 -05:00
pktgen.conf-2-2 samples/pktgen: Show the results rather than just commenting where they are 2015-02-23 22:04:25 -05:00
README.rst pktgen: new pktgen helper functions for samples scripts 2015-05-22 23:59:16 -04:00

Sample and benchmark scripts for pktgen (packet generator)
==========================================================
This directory contains some pktgen sample and benchmark scripts, that
can easily be copied and adjusted for your own use-case.

General doc is located in kernel: Documentation/networking/pktgen.txt

Helper include files
====================
This directory contains two helper shell files, that can be "included"
by shell source'ing.  Namely "functions.sh" and "parameters.sh".

Common parameters
-----------------
The parameters.sh file support easy and consistant parameter parsing
across the sample scripts.  Usage example is printed on errors::

 Usage: ./pktgen_sample01_simple.sh [-vx] -i ethX
  -i : ($DEV)       output interface/device (required)
  -s : ($PKT_SIZE)  packet size
  -d : ($DEST_IP)   destination IP
  -m : ($DST_MAC)   destination MAC-addr
  -t : ($THREADS)   threads to start
  -c : ($SKB_CLONE) SKB clones send before alloc new SKB
  -b : ($BURST)     HW level bursting of SKBs
  -v : ($VERBOSE)   verbose
  -x : ($DEBUG)     debug

The global variable being set is also listed.  E.g. the required
interface/device parameter "-i" sets variable $DEV.

Common functions
----------------
The functions.sh file provides; Three different shell functions for
configuring the different components of pktgen: pg_ctrl(), pg_thread()
and pg_set().

These functions correspond to pktgens different components.
 * pg_ctrl()   control "pgctrl" (/proc/net/pktgen/pgctrl)
 * pg_thread() control the kernel threads and binding to devices
 * pg_set()    control setup of individual devices

See sample scripts for usage examples.