LXR linux/samples/pktgen/pktgen_sample03_burst_single

   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 "$DEST_IP" ]; then
  37    validate_addr${IP6} $DEST_IP
  38    read -r DST_MIN DST_MAX <<< $(parse_addr${IP6} $DEST_IP)
  39fi
  40if [ -n "$DST_PORT" ]; then
  41    read -r UDP_DST_MIN UDP_DST_MAX <<< $(parse_ports $DST_PORT)
  42    validate_ports $UDP_DST_MIN $UDP_DST_MAX
  43fi
  44
  45# General cleanup everything since last run
  46[ -z "$APPEND" ] && pg_ctrl "reset"
  47
  48# Threads are specified with parameter -t value in $THREADS
  49for ((thread = $F_THREAD; thread <= $L_THREAD; thread++)); do
  50    dev=${DEV}@${thread}
  51
  52    # Add remove all other devices and add_device $dev to thread
  53    [ -z "$APPEND" ] && pg_thread $thread "rem_device_all"
  54    pg_thread $thread "add_device" $dev
  55
  56    # Base config
  57    pg_set $dev "flag QUEUE_MAP_CPU"
  58    pg_set $dev "count $COUNT"
  59    pg_set $dev "clone_skb $CLONE_SKB"
  60    pg_set $dev "pkt_size $PKT_SIZE"
  61    pg_set $dev "delay $DELAY"
  62    pg_set $dev "flag NO_TIMESTAMP"
  63
  64    # Destination
  65    pg_set $dev "dst_mac $DST_MAC"
  66    pg_set $dev "dst${IP6}_min $DST_MIN"
  67    pg_set $dev "dst${IP6}_max $DST_MAX"
  68
  69    if [ -n "$DST_PORT" ]; then
  70        # Single destination port or random port range
  71        pg_set $dev "flag UDPDST_RND"
  72        pg_set $dev "udp_dst_min $UDP_DST_MIN"
  73        pg_set $dev "udp_dst_max $UDP_DST_MAX"
  74    fi
  75
  76    [ ! -z "$UDP_CSUM" ] && pg_set $dev "flag UDPCSUM"
  77
  78    # Setup burst, for easy testing -b 0 disable bursting
  79    # (internally in pktgen default and minimum burst=1)
  80    if [[ ${BURST} -ne 0 ]]; then
  81        pg_set $dev "burst $BURST"
  82    else
  83        info "$dev: Not using burst"
  84    fi
  85done
  86
  87# Run if user hits control-c
  88function print_result() {
  89    # Print results
  90    for ((thread = $F_THREAD; thread <= $L_THREAD; thread++)); do
  91        dev=${DEV}@${thread}
  92        echo "Device: $dev"
  93        cat /proc/net/pktgen/$dev | grep -A2 "Result:"
  94    done
  95}
  96# trap keyboard interrupt (Ctrl-C)
  97trap true SIGINT
  98
  99if [ -z "$APPEND" ]; then
 100    echo "Running... ctrl^C to stop" >&2
 101    pg_ctrl "start"
 102
 103    print_result
 104else
 105    echo "Append mode: config done. Do more or use 'pg_ctrl start' to run"
 106fi
 107