1#!/bin/bash
2# SPDX-License-Identifier: GPL-2.0
3#
4# Script for max single flow performance
5#  - If correctly tuned[1], single CPU 10G wirespeed small pkts is possible[2]
6#
7# Using pktgen "burst" option (use -b $N)
8#  - To boost max performance
9#  - Avail since: kernel v3.18
10#   * commit 38b2cf2982dc73 ("net: pktgen: packet bursting via skb->xmit_more")
11#  - This avoids writing the HW tailptr on every driver xmit
12#  - The performance boost is impressive, see commit and blog [2]
13#
14# Notice: On purpose generates a single (UDP) flow towards target,
15#   reason behind this is to only overload/activate a single CPU on
16#   target host.  And no randomness for pktgen also makes it faster.
17#
18# Tuning see:
19#  [1] http://netoptimizer.blogspot.dk/2014/06/pktgen-for-network-overload-testing.html
20#  [2] http://netoptimizer.blogspot.dk/2014/10/unlocked-10gbps-tx-wirespeed-smallest.html
21#
22basedir=`dirname $0`
23source ${basedir}/functions.sh
24root_check_run_with_sudo "$@"
25
26# Parameter parsing via include
27source ${basedir}/parameters.sh
28# Set some default params, if they didn't get set
29if [ -z "$DEST_IP" ]; then
30    [ -z "$IP6" ] && DEST_IP="198.18.0.42" || DEST_IP="FD00::1"
31fi
32[ -z "$DST_MAC" ]   && DST_MAC="90:e2:ba:ff:ff:ff"
33[ -z "$BURST" ]     && BURST=32
34[ -z "$CLONE_SKB" ] && CLONE_SKB="0" # No need for clones when bursting
35[ -z "$COUNT" ]     && COUNT="0" # Zero means indefinitely
36if [ -n "$DST_PORT" ]; then
37    read -r DST_MIN DST_MAX <<< $(parse_ports $DST_PORT)
38    validate_ports $DST_MIN $DST_MAX
39fi
40
41# Base Config
42DELAY="0"  # Zero means max speed
43
44# General cleanup everything since last run
45pg_ctrl "reset"
46
47# Threads are specified with parameter -t value in $THREADS
48for ((thread = $F_THREAD; thread <= $L_THREAD; thread++)); do
49    dev=${DEV}@${thread}
50
51    # Add remove all other devices and add_device $dev to thread
52    pg_thread $thread "rem_device_all"
53    pg_thread $thread "add_device" $dev
54
55    # Base config
56    pg_set $dev "flag QUEUE_MAP_CPU"
57    pg_set $dev "count $COUNT"
58    pg_set $dev "clone_skb $CLONE_SKB"
59    pg_set $dev "pkt_size $PKT_SIZE"
60    pg_set $dev "delay $DELAY"
61    pg_set $dev "flag NO_TIMESTAMP"
62
63    # Destination
64    pg_set $dev "dst_mac $DST_MAC"
65    pg_set $dev "dst$IP6 $DEST_IP"
66
67    if [ -n "$DST_PORT" ]; then
68	# Single destination port or random port range
69	pg_set $dev "flag UDPDST_RND"
70	pg_set $dev "udp_dst_min $DST_MIN"
71	pg_set $dev "udp_dst_max $DST_MAX"
72    fi
73
74    # Setup burst, for easy testing -b 0 disable bursting
75    # (internally in pktgen default and minimum burst=1)
76    if [[ ${BURST} -ne 0 ]]; then
77	pg_set $dev "burst $BURST"
78    else
79	info "$dev: Not using burst"
80    fi
81done
82
83# Run if user hits control-c
84function control_c() {
85    # Print results
86    for ((thread = $F_THREAD; thread <= $L_THREAD; thread++)); do
87	dev=${DEV}@${thread}
88	echo "Device: $dev"
89	cat /proc/net/pktgen/$dev | grep -A2 "Result:"
90    done
91}
92# trap keyboard interrupt (Ctrl-C)
93trap control_c SIGINT
94
95echo "Running... ctrl^C to stop" >&2
96pg_ctrl "start"
97