Linux Audio

Check our new training course

Embedded Linux training

Mar 10-20, 2025, special US time zones
Register
Loading...
v6.13.7
  1#!/bin/bash
  2# SPDX-License-Identifier: GPL-2.0
  3# Copyright(c) 2020 Intel Corporation, Weqaar Janjua <weqaar.a.janjua@intel.com>
  4
  5# AF_XDP selftests based on veth
  6#
  7# End-to-end AF_XDP over Veth test
  8#
  9# Topology:
 10# ---------
 11#                 -----------
 12#               _ | Process | _
 13#              /  -----------  \
 14#             /        |        \
 15#            /         |         \
 16#      -----------     |     -----------
 17#      | Thread1 |     |     | Thread2 |
 18#      -----------     |     -----------
 19#           |          |          |
 20#      -----------     |     -----------
 21#      |  xskX   |     |     |  xskY   |
 22#      -----------     |     -----------
 23#           |          |          |
 24#      -----------     |     ----------
 25#      |  vethX  | --------- |  vethY |
 26#      -----------   peer    ----------
 27#
 28# AF_XDP is an address family optimized for high performance packet processing,
 29# it is XDP’s user-space interface.
 30#
 31# An AF_XDP socket is linked to a single UMEM which is a region of virtual
 32# contiguous memory, divided into equal-sized frames.
 33#
 34# Refer to AF_XDP Kernel Documentation for detailed information:
 35# https://www.kernel.org/doc/html/latest/networking/af_xdp.html
 36#
 37# Prerequisites setup by script:
 38#
 39#   Set up veth interfaces as per the topology shown ^^:
 40#   * setup two veth interfaces
 41#   ** veth<xxxx>
 42#   ** veth<yyyy>
 43#   *** xxxx and yyyy are randomly generated 4 digit numbers used to avoid
 44#       conflict with any existing interface
 45#   * tests the veth and xsk layers of the topology
 46#
 47# See the source xskxceiver.c for information on each test
 48#
 49# Kernel configuration:
 50# ---------------------
 51# See "config" file for recommended kernel config options.
 52#
 53# Turn on XDP sockets and veth support when compiling i.e.
 54# 	Networking support -->
 55# 		Networking options -->
 56# 			[ * ] XDP sockets
 57#
 58# Executing Tests:
 59# ----------------
 60# Must run with CAP_NET_ADMIN capability.
 61#
 62# Run:
 63#   sudo ./test_xsk.sh
 64#
 65# If running from kselftests:
 66#   sudo make run_tests
 67#
 68# Run with verbose output:
 69#   sudo ./test_xsk.sh -v
 70#
 71# Set up veth interfaces and leave them up so xskxceiver can be launched in a debugger:
 72#   sudo ./test_xsk.sh -d
 73#
 74# Run test suite for physical device in loopback mode
 75#   sudo ./test_xsk.sh -i IFACE
 76#
 77# Run test suite in a specific mode only [skb,drv,zc]
 78#   sudo ./test_xsk.sh -m MODE
 79#
 80# List available tests
 81#   ./test_xsk.sh -l
 82#
 83# Run a specific test from the test suite
 84#   sudo ./test_xsk.sh -t TEST_NAME
 85#
 86# Display the available command line options
 87#   ./test_xsk.sh -h
 88
 89. xsk_prereqs.sh
 90
 91ETH=""
 92
 93while getopts "vi:dm:lt:h" flag
 94do
 95	case "${flag}" in
 96		v) verbose=1;;
 97		d) debug=1;;
 98		i) ETH=${OPTARG};;
 99		m) MODE=${OPTARG};;
100		l) list=1;;
101		t) TEST=${OPTARG};;
102		h) help=1;;
103	esac
104done
105
106TEST_NAME="PREREQUISITES"
107
108URANDOM=/dev/urandom
109[ ! -e "${URANDOM}" ] && { echo "${URANDOM} not found. Skipping tests."; test_exit $ksft_fail; }
110
111VETH0_POSTFIX=$(cat ${URANDOM} | tr -dc '0-9' | fold -w 256 | head -n 1 | head --bytes 4)
112VETH0=ve${VETH0_POSTFIX}
113VETH1_POSTFIX=$(cat ${URANDOM} | tr -dc '0-9' | fold -w 256 | head -n 1 | head --bytes 4)
114VETH1=ve${VETH1_POSTFIX}
115MTU=1500
116
117trap ctrl_c INT
118
119function ctrl_c() {
120        cleanup_exit ${VETH0} ${VETH1}
121	exit 1
122}
123
124setup_vethPairs() {
125	if [[ $verbose -eq 1 ]]; then
126	        echo "setting up ${VETH0}"
127	fi
128	ip link add ${VETH0} numtxqueues 4 numrxqueues 4 type veth peer name ${VETH1} numtxqueues 4 numrxqueues 4
129	if [ -f /proc/net/if_inet6 ]; then
130		echo 1 > /proc/sys/net/ipv6/conf/${VETH0}/disable_ipv6
131		echo 1 > /proc/sys/net/ipv6/conf/${VETH1}/disable_ipv6
132	fi
133	if [[ $verbose -eq 1 ]]; then
134	        echo "setting up ${VETH1}"
135	fi
136
137	if [[ $busy_poll -eq 1 ]]; then
138	        echo 2 > /sys/class/net/${VETH0}/napi_defer_hard_irqs
139		echo 200000 > /sys/class/net/${VETH0}/gro_flush_timeout
140		echo 2 > /sys/class/net/${VETH1}/napi_defer_hard_irqs
141		echo 200000 > /sys/class/net/${VETH1}/gro_flush_timeout
142	fi
143
144	ip link set ${VETH1} mtu ${MTU}
145	ip link set ${VETH0} mtu ${MTU}
146	ip link set ${VETH1} up
147	ip link set ${VETH0} up
148}
149
150if [[ $list -eq 1 ]]; then
151        ./${XSKOBJ} -l
152        exit
153fi
154
155if [[ $help -eq 1 ]]; then
156	./${XSKOBJ}
157        exit
158fi
159
160if [ ! -z $ETH ]; then
161	VETH0=${ETH}
162	VETH1=${ETH}
163else
164	validate_root_exec
165	validate_veth_support ${VETH0}
166	validate_ip_utility
167	setup_vethPairs
168
169	retval=$?
170	if [ $retval -ne 0 ]; then
171		test_status $retval "${TEST_NAME}"
172		cleanup_exit ${VETH0} ${VETH1}
173		exit $retval
174	fi
175fi
176
177
178if [[ $verbose -eq 1 ]]; then
179	ARGS+="-v "
180fi
181
182if [ -n "$MODE" ]; then
183	ARGS+="-m ${MODE} "
184fi
185
186if [ -n "$TEST" ]; then
187	ARGS+="-t ${TEST} "
188fi
189
190retval=$?
191test_status $retval "${TEST_NAME}"
192
193## START TESTS
194
195statusList=()
196
197TEST_NAME="XSK_SELFTESTS_${VETH0}_SOFTIRQ"
198
199if [[ $debug -eq 1 ]]; then
200    echo "-i" ${VETH0} "-i" ${VETH1}
201    exit
202fi
203
204exec_xskxceiver
205
206if [ -z $ETH ]; then
207	cleanup_exit ${VETH0} ${VETH1}
208else
209	cleanup_iface ${ETH} ${MTU}
210fi
211
212if [[ $list -eq 1 ]]; then
213    exit
214fi
215
216TEST_NAME="XSK_SELFTESTS_${VETH0}_BUSY_POLL"
217busy_poll=1
218
219if [ -z $ETH ]; then
220	setup_vethPairs
221fi
222exec_xskxceiver
223
224## END TESTS
225
226if [ -z $ETH ]; then
227	cleanup_exit ${VETH0} ${VETH1}
228else
229	cleanup_iface ${ETH} ${MTU}
230fi
231
232failures=0
233echo -e "\nSummary:"
234for i in "${!statusList[@]}"
235do
236	if [ ${statusList[$i]} -ne 0 ]; then
237	        test_status ${statusList[$i]} ${nameList[$i]}
238		failures=1
239	fi
240done
241
242if [ $failures -eq 0 ]; then
243        echo "All tests successful!"
244fi
v6.8
  1#!/bin/bash
  2# SPDX-License-Identifier: GPL-2.0
  3# Copyright(c) 2020 Intel Corporation, Weqaar Janjua <weqaar.a.janjua@intel.com>
  4
  5# AF_XDP selftests based on veth
  6#
  7# End-to-end AF_XDP over Veth test
  8#
  9# Topology:
 10# ---------
 11#                 -----------
 12#               _ | Process | _
 13#              /  -----------  \
 14#             /        |        \
 15#            /         |         \
 16#      -----------     |     -----------
 17#      | Thread1 |     |     | Thread2 |
 18#      -----------     |     -----------
 19#           |          |          |
 20#      -----------     |     -----------
 21#      |  xskX   |     |     |  xskY   |
 22#      -----------     |     -----------
 23#           |          |          |
 24#      -----------     |     ----------
 25#      |  vethX  | --------- |  vethY |
 26#      -----------   peer    ----------
 27#
 28# AF_XDP is an address family optimized for high performance packet processing,
 29# it is XDP’s user-space interface.
 30#
 31# An AF_XDP socket is linked to a single UMEM which is a region of virtual
 32# contiguous memory, divided into equal-sized frames.
 33#
 34# Refer to AF_XDP Kernel Documentation for detailed information:
 35# https://www.kernel.org/doc/html/latest/networking/af_xdp.html
 36#
 37# Prerequisites setup by script:
 38#
 39#   Set up veth interfaces as per the topology shown ^^:
 40#   * setup two veth interfaces
 41#   ** veth<xxxx>
 42#   ** veth<yyyy>
 43#   *** xxxx and yyyy are randomly generated 4 digit numbers used to avoid
 44#       conflict with any existing interface
 45#   * tests the veth and xsk layers of the topology
 46#
 47# See the source xskxceiver.c for information on each test
 48#
 49# Kernel configuration:
 50# ---------------------
 51# See "config" file for recommended kernel config options.
 52#
 53# Turn on XDP sockets and veth support when compiling i.e.
 54# 	Networking support -->
 55# 		Networking options -->
 56# 			[ * ] XDP sockets
 57#
 58# Executing Tests:
 59# ----------------
 60# Must run with CAP_NET_ADMIN capability.
 61#
 62# Run:
 63#   sudo ./test_xsk.sh
 64#
 65# If running from kselftests:
 66#   sudo make run_tests
 67#
 68# Run with verbose output:
 69#   sudo ./test_xsk.sh -v
 70#
 71# Set up veth interfaces and leave them up so xskxceiver can be launched in a debugger:
 72#   sudo ./test_xsk.sh -d
 73#
 74# Run test suite for physical device in loopback mode
 75#   sudo ./test_xsk.sh -i IFACE
 76#
 77# Run test suite in a specific mode only [skb,drv,zc]
 78#   sudo ./test_xsk.sh -m MODE
 79#
 80# List available tests
 81#   ./test_xsk.sh -l
 82#
 83# Run a specific test from the test suite
 84#   sudo ./test_xsk.sh -t TEST_NAME
 85#
 86# Display the available command line options
 87#   ./test_xsk.sh -h
 88
 89. xsk_prereqs.sh
 90
 91ETH=""
 92
 93while getopts "vi:dm:lt:h" flag
 94do
 95	case "${flag}" in
 96		v) verbose=1;;
 97		d) debug=1;;
 98		i) ETH=${OPTARG};;
 99		m) MODE=${OPTARG};;
100		l) list=1;;
101		t) TEST=${OPTARG};;
102		h) help=1;;
103	esac
104done
105
106TEST_NAME="PREREQUISITES"
107
108URANDOM=/dev/urandom
109[ ! -e "${URANDOM}" ] && { echo "${URANDOM} not found. Skipping tests."; test_exit $ksft_fail; }
110
111VETH0_POSTFIX=$(cat ${URANDOM} | tr -dc '0-9' | fold -w 256 | head -n 1 | head --bytes 4)
112VETH0=ve${VETH0_POSTFIX}
113VETH1_POSTFIX=$(cat ${URANDOM} | tr -dc '0-9' | fold -w 256 | head -n 1 | head --bytes 4)
114VETH1=ve${VETH1_POSTFIX}
115MTU=1500
116
117trap ctrl_c INT
118
119function ctrl_c() {
120        cleanup_exit ${VETH0} ${VETH1}
121	exit 1
122}
123
124setup_vethPairs() {
125	if [[ $verbose -eq 1 ]]; then
126	        echo "setting up ${VETH0}"
127	fi
128	ip link add ${VETH0} numtxqueues 4 numrxqueues 4 type veth peer name ${VETH1} numtxqueues 4 numrxqueues 4
129	if [ -f /proc/net/if_inet6 ]; then
130		echo 1 > /proc/sys/net/ipv6/conf/${VETH0}/disable_ipv6
131		echo 1 > /proc/sys/net/ipv6/conf/${VETH1}/disable_ipv6
132	fi
133	if [[ $verbose -eq 1 ]]; then
134	        echo "setting up ${VETH1}"
135	fi
136
137	if [[ $busy_poll -eq 1 ]]; then
138	        echo 2 > /sys/class/net/${VETH0}/napi_defer_hard_irqs
139		echo 200000 > /sys/class/net/${VETH0}/gro_flush_timeout
140		echo 2 > /sys/class/net/${VETH1}/napi_defer_hard_irqs
141		echo 200000 > /sys/class/net/${VETH1}/gro_flush_timeout
142	fi
143
144	ip link set ${VETH1} mtu ${MTU}
145	ip link set ${VETH0} mtu ${MTU}
146	ip link set ${VETH1} up
147	ip link set ${VETH0} up
148}
149
150if [[ $list -eq 1 ]]; then
151        ./${XSKOBJ} -l
152        exit
153fi
154
155if [[ $help -eq 1 ]]; then
156	./${XSKOBJ}
157        exit
158fi
159
160if [ ! -z $ETH ]; then
161	VETH0=${ETH}
162	VETH1=${ETH}
163else
164	validate_root_exec
165	validate_veth_support ${VETH0}
166	validate_ip_utility
167	setup_vethPairs
168
169	retval=$?
170	if [ $retval -ne 0 ]; then
171		test_status $retval "${TEST_NAME}"
172		cleanup_exit ${VETH0} ${VETH1}
173		exit $retval
174	fi
175fi
176
177
178if [[ $verbose -eq 1 ]]; then
179	ARGS+="-v "
180fi
181
182if [ -n "$MODE" ]; then
183	ARGS+="-m ${MODE} "
184fi
185
186if [ -n "$TEST" ]; then
187	ARGS+="-t ${TEST} "
188fi
189
190retval=$?
191test_status $retval "${TEST_NAME}"
192
193## START TESTS
194
195statusList=()
196
197TEST_NAME="XSK_SELFTESTS_${VETH0}_SOFTIRQ"
198
199if [[ $debug -eq 1 ]]; then
200    echo "-i" ${VETH0} "-i" ${VETH1}
201    exit
202fi
203
204exec_xskxceiver
205
206if [ -z $ETH ]; then
207	cleanup_exit ${VETH0} ${VETH1}
208else
209	cleanup_iface ${ETH} ${MTU}
210fi
211
212if [[ $list -eq 1 ]]; then
213    exit
214fi
215
216TEST_NAME="XSK_SELFTESTS_${VETH0}_BUSY_POLL"
217busy_poll=1
218
219if [ -z $ETH ]; then
220	setup_vethPairs
221fi
222exec_xskxceiver
223
224## END TESTS
225
226if [ -z $ETH ]; then
227	cleanup_exit ${VETH0} ${VETH1}
228else
229	cleanup_iface ${ETH} ${MTU}
230fi
231
232failures=0
233echo -e "\nSummary:"
234for i in "${!statusList[@]}"
235do
236	if [ ${statusList[$i]} -ne 0 ]; then
237	        test_status ${statusList[$i]} ${nameList[$i]}
238		failures=1
239	fi
240done
241
242if [ $failures -eq 0 ]; then
243        echo "All tests successful!"
244fi