Documentation/networking/pktgen.rst

1 .. SPDX-License-Identifier: GPL-2.0
7 Enable CONFIG_NET_PKTGEN to compile and build pktgen either in-kernel
11 suitable sample script and configure that.
31 overload type of benchmarking, as this could hurt the normal use-case.
35  # ethtool -G ethX tx 1024
43 TX ring cause delay.  Drivers usually delay cleaning up the
44 ring-buffers for various performance reasons, and packets stalling
48 (Intel 82599 chip).  This driver (ixgbe) combines TX+RX ring cleanups,
49 and the cleanup interval is affected by the ethtool --coalesce setting
50 of parameter "rx-usecs".
54  # ethtool -C ethX rx-usecs 30
72  * add_device DEVICE@NAME -- adds a single device
73  * rem_device_all         -- remove all associated devices
96 	frags: 0  delay: 0  clone_skb: 64  ifname: eth4@0
106 	pkts-sofar: 100000  errors: 0
120 as defined in the sample scripts.
121 You need to specify PGDEV environment variable to use functions from sample
142  pgset "delay 5000"      adds delay to hard_start_xmit(). nanoseconds
212  pgset "vlan_id 77"       set VLAN ID 0-4095
213  pgset "vlan_p 3"         set priority bit 0-7 (default 0)
214  pgset "vlan_cfi 0"       set canonical format identifier 0-1 (default 0)
216  pgset "svlan_id 22"      set SVLAN ID 0-4095
217  pgset "svlan_p 3"        set priority bit 0-7 (default 0)
218  pgset "svlan_cfi 0"      set canonical format identifier 0-1 (default 0)
230  pgset "xmit_mode netif_receive"  RX inject into stack netif_receive_skb()
234 Sample scripts
239 and consistent parameter parsing across the sample scripts.
243  ./pktgen_sample01_simple.sh -i eth4 -m 00:1B:21:3C:9D:F8 -d 192.168.8.2
247   ./pktgen_sample01_simple.sh [-vx] -i ethX
249   -i : ($DEV)       output interface/device (required)
250   -s : ($PKT_SIZE)  packet size
251   -d : ($DEST_IP)   destination IP. CIDR (e.g. 198.18.0.0/15) is also allowed
252   -m : ($DST_MAC)   destination MAC-addr
253   -p : ($DST_PORT)  destination PORT range (e.g. 433-444) is also allowed
254   -t : ($THREADS)   threads to start
255   -f : ($F_THREAD)  index of first thread (zero indexed CPU number)
256   -c : ($SKB_CLONE) SKB clones send before alloc new SKB
257   -n : ($COUNT)     num messages to send per thread, 0 means indefinitely
258   -b : ($BURST)     HW level bursting of SKBs
259   -v : ($VERBOSE)   verbose
260   -x : ($DEBUG)     debug
261   -6 : ($IP6)       IPv6
262   -w : ($DELAY)     Tx Delay value (ns)
263   -a : ($APPEND)    Script will not reset generator's state, but will append its config
266 interface/device parameter "-i" sets variable $DEV.  Copy the
315     delay
398 - ftp://robur.slu.se/pub/Linux/net-development/pktgen-testing/
399 - ftp://robur.slu.se/pub/Linux/net-development/pktgen-testing/examples/
401 Paper from Linux-Kongress in Erlangen 2004.
402 - ftp://robur.slu.se/pub/Linux/net-development/pktgen-testing/pktgen_paper.pdf
406 Grant Grundler for testing on IA-64 and parisc, Harald Welte,  Lennert Buytenhek
410 Good luck with the linux net-development.