xref: /linux/tools/testing/selftests/rcutorture/bin/functions.sh (revision e9f0878c4b2004ac19581274c1ae4c61ae3ca70e)
1#!/bin/bash
2#
3# Shell functions for the rest of the scripts.
4#
5# This program is free software; you can redistribute it and/or modify
6# it under the terms of the GNU General Public License as published by
7# the Free Software Foundation; either version 2 of the License, or
8# (at your option) any later version.
9#
10# This program is distributed in the hope that it will be useful,
11# but WITHOUT ANY WARRANTY; without even the implied warranty of
12# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13# GNU General Public License for more details.
14#
15# You should have received a copy of the GNU General Public License
16# along with this program; if not, you can access it online at
17# http://www.gnu.org/licenses/gpl-2.0.html.
18#
19# Copyright (C) IBM Corporation, 2013
20#
21# Authors: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
22
23# bootparam_hotplug_cpu bootparam-string
24#
25# Returns 1 if the specified boot-parameter string tells rcutorture to
26# test CPU-hotplug operations.
27bootparam_hotplug_cpu () {
28	echo "$1" | grep -q "rcutorture\.onoff_"
29}
30
31# checkarg --argname argtype $# arg mustmatch cannotmatch
32#
33# Checks the specified argument "arg" against the mustmatch and cannotmatch
34# patterns.
35checkarg () {
36	if test $3 -le 1
37	then
38		echo $1 needs argument $2 matching \"$5\"
39		usage
40	fi
41	if echo "$4" | grep -q -e "$5"
42	then
43		:
44	else
45		echo $1 $2 \"$4\" must match \"$5\"
46		usage
47	fi
48	if echo "$4" | grep -q -e "$6"
49	then
50		echo $1 $2 \"$4\" must not match \"$6\"
51		usage
52	fi
53}
54
55# configfrag_boot_params bootparam-string config-fragment-file
56#
57# Adds boot parameters from the .boot file, if any.
58configfrag_boot_params () {
59	if test -r "$2.boot"
60	then
61		echo $1 `grep -v '^#' "$2.boot" | tr '\012' ' '`
62	else
63		echo $1
64	fi
65}
66
67# configfrag_boot_cpus bootparam-string config-fragment-file config-cpus
68#
69# Decreases number of CPUs based on any nr_cpus= boot parameters specified.
70configfrag_boot_cpus () {
71	local bootargs="`configfrag_boot_params "$1" "$2"`"
72	local nr_cpus
73	if echo "${bootargs}" | grep -q 'nr_cpus=[0-9]'
74	then
75		nr_cpus="`echo "${bootargs}" | sed -e 's/^.*nr_cpus=\([0-9]*\).*$/\1/'`"
76		if test "$3" -gt "$nr_cpus"
77		then
78			echo $nr_cpus
79		else
80			echo $3
81		fi
82	else
83		echo $3
84	fi
85}
86
87# configfrag_boot_maxcpus bootparam-string config-fragment-file config-cpus
88#
89# Decreases number of CPUs based on any maxcpus= boot parameters specified.
90# This allows tests where additional CPUs come online later during the
91# test run.  However, the torture parameters will be set based on the
92# number of CPUs initially present, so the scripting should schedule
93# test runs based on the maxcpus= boot parameter controlling the initial
94# number of CPUs instead of on the ultimate number of CPUs.
95configfrag_boot_maxcpus () {
96	local bootargs="`configfrag_boot_params "$1" "$2"`"
97	local maxcpus
98	if echo "${bootargs}" | grep -q 'maxcpus=[0-9]'
99	then
100		maxcpus="`echo "${bootargs}" | sed -e 's/^.*maxcpus=\([0-9]*\).*$/\1/'`"
101		if test "$3" -gt "$maxcpus"
102		then
103			echo $maxcpus
104		else
105			echo $3
106		fi
107	else
108		echo $3
109	fi
110}
111
112# configfrag_hotplug_cpu config-fragment-file
113#
114# Returns 1 if the config fragment specifies hotplug CPU.
115configfrag_hotplug_cpu () {
116	if test ! -r "$1"
117	then
118		echo Unreadable config fragment "$1" 1>&2
119		exit -1
120	fi
121	grep -q '^CONFIG_HOTPLUG_CPU=y$' "$1"
122}
123
124# identify_boot_image qemu-cmd
125#
126# Returns the relative path to the kernel build image.  This will be
127# arch/<arch>/boot/bzImage or vmlinux if bzImage is not a target for the
128# architecture, unless overridden with the TORTURE_BOOT_IMAGE environment
129# variable.
130identify_boot_image () {
131	if test -n "$TORTURE_BOOT_IMAGE"
132	then
133		echo $TORTURE_BOOT_IMAGE
134	else
135		case "$1" in
136		qemu-system-x86_64|qemu-system-i386)
137			echo arch/x86/boot/bzImage
138			;;
139		qemu-system-aarch64)
140			echo arch/arm64/boot/Image
141			;;
142		*)
143			echo vmlinux
144			;;
145		esac
146	fi
147}
148
149# identify_qemu builddir
150#
151# Returns our best guess as to which qemu command is appropriate for
152# the kernel at hand.  Override with the TORTURE_QEMU_CMD environment variable.
153identify_qemu () {
154	local u="`file "$1"`"
155	if test -n "$TORTURE_QEMU_CMD"
156	then
157		echo $TORTURE_QEMU_CMD
158	elif echo $u | grep -q x86-64
159	then
160		echo qemu-system-x86_64
161	elif echo $u | grep -q "Intel 80386"
162	then
163		echo qemu-system-i386
164	elif echo $u | grep -q aarch64
165	then
166		echo qemu-system-aarch64
167	elif uname -a | grep -q ppc64
168	then
169		echo qemu-system-ppc64
170	else
171		echo Cannot figure out what qemu command to use! 1>&2
172		echo file $1 output: $u
173		# Usually this will be one of /usr/bin/qemu-system-*
174		# Use TORTURE_QEMU_CMD environment variable or appropriate
175		# argument to top-level script.
176		exit 1
177	fi
178}
179
180# identify_qemu_append qemu-cmd
181#
182# Output arguments for the qemu "-append" string based on CPU type
183# and the TORTURE_QEMU_INTERACTIVE environment variable.
184identify_qemu_append () {
185	local console=ttyS0
186	case "$1" in
187	qemu-system-x86_64|qemu-system-i386)
188		echo noapic selinux=0 initcall_debug debug
189		;;
190	qemu-system-aarch64)
191		console=ttyAMA0
192		;;
193	esac
194	if test -n "$TORTURE_QEMU_INTERACTIVE"
195	then
196		echo root=/dev/sda
197	else
198		echo console=$console
199	fi
200}
201
202# identify_qemu_args qemu-cmd serial-file
203#
204# Output arguments for qemu arguments based on the TORTURE_QEMU_MAC
205# and TORTURE_QEMU_INTERACTIVE environment variables.
206identify_qemu_args () {
207	case "$1" in
208	qemu-system-x86_64|qemu-system-i386)
209		;;
210	qemu-system-aarch64)
211		echo -machine virt,gic-version=host -cpu host
212		;;
213	qemu-system-ppc64)
214		echo -enable-kvm -M pseries -nodefaults
215		echo -device spapr-vscsi
216		if test -n "$TORTURE_QEMU_INTERACTIVE" -a -n "$TORTURE_QEMU_MAC"
217		then
218			echo -device spapr-vlan,netdev=net0,mac=$TORTURE_QEMU_MAC
219			echo -netdev bridge,br=br0,id=net0
220		elif test -n "$TORTURE_QEMU_INTERACTIVE"
221		then
222			echo -net nic -net user
223		fi
224		;;
225	esac
226	if test -n "$TORTURE_QEMU_INTERACTIVE"
227	then
228		echo -monitor stdio -serial pty -S
229	else
230		echo -serial file:$2
231	fi
232}
233
234# identify_qemu_vcpus
235#
236# Returns the number of virtual CPUs available to the aggregate of the
237# guest OSes.
238identify_qemu_vcpus () {
239	lscpu | grep '^CPU(s):' | sed -e 's/CPU(s)://'
240}
241
242# print_bug
243#
244# Prints "BUG: " in red followed by remaining arguments
245print_bug () {
246	printf '\033[031mBUG: \033[m'
247	echo $*
248}
249
250# print_warning
251#
252# Prints "WARNING: " in yellow followed by remaining arguments
253print_warning () {
254	printf '\033[033mWARNING: \033[m'
255	echo $*
256}
257
258# specify_qemu_cpus qemu-cmd qemu-args #cpus
259#
260# Appends a string containing "-smp XXX" to qemu-args, unless the incoming
261# qemu-args already contains "-smp".
262specify_qemu_cpus () {
263	local nt;
264
265	if echo $2 | grep -q -e -smp
266	then
267		echo $2
268	else
269		case "$1" in
270		qemu-system-x86_64|qemu-system-i386|qemu-system-aarch64)
271			echo $2 -smp $3
272			;;
273		qemu-system-ppc64)
274			nt="`lscpu | grep '^NUMA node0' | sed -e 's/^[^,]*,\([0-9]*\),.*$/\1/'`"
275			echo $2 -smp cores=`expr \( $3 + $nt - 1 \) / $nt`,threads=$nt
276			;;
277		esac
278	fi
279}
280