Documentation/networking/pktgen.rst

1 .. SPDX-License-Identifier: GPL-2.0
7 Enable CONFIG_NET_PKTGEN to compile and build pktgen either in-kernel
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
107 	started: 623913381008us  stopped: 623913396439us idle: 25us
142  pgset "delay 5000"      adds delay to hard_start_xmit(). nanoseconds
186  pgset "spi [SPI_VALUE]" Set specific SA used to transform packet.
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()
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
252   -m : ($DST_MAC)   destination MAC-addr
253   -t : ($THREADS)   threads to start
254   -c : ($SKB_CLONE) SKB clones send before alloc new SKB
255   -b : ($BURST)     HW level bursting of SKBs
256   -v : ($VERBOSE)   verbose
257   -x : ($DEBUG)     debug
260 interface/device parameter "-i" sets variable $DEV.  Copy the
265     pktgen.conf-1-2                  # 1 CPU 2 dev
266     pktgen.conf-1-1-rdos             # 1 CPU 1 dev w. route DoS
267     pktgen.conf-1-1-ip6              # 1 CPU 1 dev ipv6
268     pktgen.conf-1-1-ip6-rdos         # 1 CPU 1 dev ipv6  w. route DoS
269     pktgen.conf-1-1-flows            # 1 CPU 1 dev multiple flows.
290 you can use "pgset spi SPI_VALUE" to specify which transformation mode
317     delay
363     spi (ipsec)
400 - ftp://robur.slu.se/pub/Linux/net-development/pktgen-testing/
401 - tp://robur.slu.se/pub/Linux/net-development/pktgen-testing/examples/
403 Paper from Linux-Kongress in Erlangen 2004.
404 - ftp://robur.slu.se/pub/Linux/net-development/pktgen-testing/pktgen_paper.pdf
408 Grant Grundler for testing on IA-64 and parisc, Harald Welte,  Lennert Buytenhek
412 Good luck with the linux net-development.