2 # SPDX-License-Identifier: GPL-2.0+
4 # Run a series of tests under KVM. By default, this series is specified
5 # by the relevant CFLIST file, but can be overridden by the --configs
6 # command-line argument.
8 # Usage: kvm.sh [ options ]
10 # Copyright (C) IBM Corporation, 2011
12 # Authors: Paul E. McKenney <paulmck@linux.ibm.com>
17 T=${TMPDIR-/tmp}/kvm.sh.$$
21 cd `dirname $scriptname`/../../../../../
25 KVM="`pwd`/tools/testing/selftests/rcutorture"; export KVM
26 PATH=${KVM}/bin:$PATH; export PATH
29 TORTURE_ALLOTED_CPUS="`identify_qemu_vcpus`"
30 TORTURE_DEFCONFIG=defconfig
32 TORTURE_INITRD="$KVM/initrd"; export TORTURE_INITRD
33 TORTURE_KCONFIG_ARG=""
34 TORTURE_KCONFIG_KCSAN_ARG=""
37 TORTURE_SHUTDOWN_GRACE=180
43 ds=`date +%Y.%m.%d-%H.%M.%S`
47 echo "Usage: $scriptname optional arguments:"
48 echo " --bootargs kernel-boot-arguments"
49 echo " --bootimage relative-path-to-kernel-boot-image"
51 echo " --configs \"config-file list w/ repeat factor (3*TINY01)\""
53 echo " --datestamp string"
54 echo " --defconfig string"
55 echo " --dryrun sched|script"
56 echo " --duration minutes"
58 echo " --jitter N [ maxsleep (us) [ maxspin (us) ] ]"
59 echo " --kconfig Kconfig-options"
60 echo " --kmake-arg kernel-make-arguments"
61 echo " --mac nn:nn:nn:nn:nn:nn"
62 echo " --memory megabytes | nnnG"
64 echo " --qemu-args qemu-arguments"
65 echo " --qemu-cmd qemu-system-..."
66 echo " --results absolute-pathname"
76 checkarg --bootargs "(list of kernel boot arguments)" "$#" "$2" '.*' '^--'
81 checkarg --bootimage "(relative path to kernel boot image)" "$#" "$2" '[a-zA-Z0-9][a-zA-Z0-9_]*' '^--'
82 TORTURE_BOOT_IMAGE="$2"
89 checkarg --configs "(list of config files)" "$#" "$2" '^[^/]*$' '^--'
94 checkarg --cpus "(number)" "$#" "$2" '^[0-9]*$' '^--'
96 TORTURE_ALLOTED_CPUS="$2"
97 max_cpus="`identify_qemu_vcpus`"
98 if test "$TORTURE_ALLOTED_CPUS" -gt "$max_cpus"
100 TORTURE_ALLOTED_CPUS=$max_cpus
105 checkarg --datestamp "(relative pathname)" "$#" "$2" '^[^/]*$' '^--'
110 checkarg --defconfig "defconfigtype" "$#" "$2" '^[^/][^/]*$' '^--'
115 checkarg --dryrun "sched|script" $# "$2" 'sched\|script' '^--'
120 checkarg --duration "(minutes)" $# "$2" '^[0-9]*$' '^error'
125 TORTURE_QEMU_INTERACTIVE=1; export TORTURE_QEMU_INTERACTIVE
128 checkarg --jitter "(# threads [ sleep [ spin ] ])" $# "$2" '^-\{,1\}[0-9]\+\( \+[0-9]\+\)\{,2\} *$' '^error$'
133 checkarg --kconfig "(Kconfig options)" $# "$2" '^CONFIG_[A-Z0-9_]\+=\([ynm]\|[0-9]\+\)\( CONFIG_[A-Z0-9_]\+=\([ynm]\|[0-9]\+\)\)*$' '^error$'
134 TORTURE_KCONFIG_ARG="$2"
138 TORTURE_KCONFIG_KCSAN_ARG="CONFIG_DEBUG_INFO=y CONFIG_KCSAN=y CONFIG_KCSAN_ASSUME_PLAIN_WRITES_ATOMIC=n CONFIG_KCSAN_REPORT_VALUE_CHANGE_ONLY=n CONFIG_KCSAN_REPORT_ONCE_IN_MS=100000 CONFIG_KCSAN_VERBOSE=y CONFIG_KCSAN_INTERRUPT_WATCHER=y"; export TORTURE_KCONFIG_KCSAN_ARG
141 checkarg --kmake-arg "(kernel make arguments)" $# "$2" '.*' '^error$'
142 TORTURE_KMAKE_ARG="$2"
146 checkarg --mac "(MAC address)" $# "$2" '^\([0-9a-fA-F]\{2\}:\)\{5\}[0-9a-fA-F]\{2\}$' error
151 checkarg --memory "(memory size)" $# "$2" '^[0-9]\+[MG]\?$' error
156 TORTURE_INITRD=""; export TORTURE_INITRD
158 --qemu-args|--qemu-arg)
159 checkarg --qemu-args "(qemu arguments)" $# "$2" '^-' '^error'
160 TORTURE_QEMU_ARG="$2"
164 checkarg --qemu-cmd "(qemu-system-...)" $# "$2" 'qemu-system-' '^--'
165 TORTURE_QEMU_CMD="$2"
169 checkarg --results "(absolute pathname)" "$#" "$2" '^/' '^error'
174 checkarg --shutdown-grace "(seconds)" "$#" "$2" '^[0-9]*$' '^error'
175 TORTURE_SHUTDOWN_GRACE=$2
179 checkarg --torture "(suite name)" "$#" "$2" '^\(lock\|rcu\|rcuperf\)$' '^--'
182 if test "$TORTURE_SUITE" = rcuperf
184 # If you really want jitter for rcuperf, specify
185 # it after specifying rcuperf. (But why?)
190 TORTURE_TRUST_MAKE="y"
193 echo Unknown argument $1
200 if test -z "$TORTURE_INITRD" || tools/testing/selftests/rcutorture/bin/mkinitrd.sh
204 echo No initrd and unable to create one, aborting test >&2
208 TORTURE_KCONFIG_ARG="${TORTURE_KCONFIG_ARG} ${TORTURE_KCONFIG_KCSAN_ARG}"
209 TORTURE_KCONFIG_ARG="`echo ${TORTURE_KCONFIG_ARG} | sed -e 's/^ *//' -e 's/ *$//'`"
211 CONFIGFRAG=${KVM}/configs/${TORTURE_SUITE}; export CONFIGFRAG
213 defaultconfigs="`tr '\012' ' ' < $CONFIGFRAG/CFLIST`"
214 if test -z "$configs"
216 configs=$defaultconfigs
224 # Create a file of test-name/#cpus pairs, sorted by decreasing #cpus.
229 [0-9]\**|[0-9][0-9]\**|[0-9][0-9][0-9]\**)
230 config_reps=`echo $CF | sed -e 's/\*.*$//'`
231 CF1=`echo $CF | sed -e 's/^[^*]*\*//'`
238 for ((cur_rep=0;cur_rep<$config_reps;cur_rep++))
240 configs_derep="$configs_derep $CF1"
244 configs_derep="`echo $configs_derep | sed -e "s/\<CFLIST\>/$defaultconfigs/g"`"
245 for CF1 in $configs_derep
247 if test -f "$CONFIGFRAG/$CF1"
249 cpu_count=`configNR_CPUS.sh $CONFIGFRAG/$CF1`
250 cpu_count=`configfrag_boot_cpus "$TORTURE_BOOTARGS" "$CONFIGFRAG/$CF1" "$cpu_count"`
251 cpu_count=`configfrag_boot_maxcpus "$TORTURE_BOOTARGS" "$CONFIGFRAG/$CF1" "$cpu_count"`
252 echo $CF1 $cpu_count >> $T/cfgcpu
254 echo "The --configs file $CF1 does not exist, terminating."
258 sort -k2nr $T/cfgcpu -T="$T" > $T/cfgcpu.sort
260 # Use a greedy bin-packing algorithm, sorting the list accordingly.
261 awk < $T/cfgcpu.sort > $T/cfgcpu.pack -v ncpus=$cpus '
267 # Read file of tests and corresponding required numbers of CPUs.
277 # Each pass through the following loop creates on test batch
278 # that can be executed concurrently given ncpus. Note that a
279 # given test that requires more than the available CPUs will run in
280 # their own batch. Such tests just have to make do with what
282 while (nc != ncpus) {
286 # Each pass through the following loop considers one
287 # test for inclusion in the current batch.
288 for (i = 0; i < njobs; i++) {
290 continue; # Already part of a batch.
291 if (nc >= cpus[i] || nc == ncpus) {
293 # This test fits into the current batch.
297 break; # Too-big test in its own batch.
302 # Dump out the tests in batch order.
303 for (b = 1; b <= batch; b++)
304 for (i = 0; i < njobs; i++)
306 print cf[i], cpus[i];
309 # Generate a script to execute the tests in appropriate batches.
310 cat << ___EOF___ > $T/script
311 CONFIGFRAG="$CONFIGFRAG"; export CONFIGFRAG
312 KVM="$KVM"; export KVM
313 PATH="$PATH"; export PATH
314 TORTURE_ALLOTED_CPUS="$TORTURE_ALLOTED_CPUS"; export TORTURE_ALLOTED_CPUS
315 TORTURE_BOOT_IMAGE="$TORTURE_BOOT_IMAGE"; export TORTURE_BOOT_IMAGE
316 TORTURE_BUILDONLY="$TORTURE_BUILDONLY"; export TORTURE_BUILDONLY
317 TORTURE_DEFCONFIG="$TORTURE_DEFCONFIG"; export TORTURE_DEFCONFIG
318 TORTURE_INITRD="$TORTURE_INITRD"; export TORTURE_INITRD
319 TORTURE_KCONFIG_ARG="$TORTURE_KCONFIG_ARG"; export TORTURE_KCONFIG_ARG
320 TORTURE_KCONFIG_KCSAN_ARG="$TORTURE_KCONFIG_KCSAN_ARG"; export TORTURE_KCONFIG_KCSAN_ARG
321 TORTURE_KMAKE_ARG="$TORTURE_KMAKE_ARG"; export TORTURE_KMAKE_ARG
322 TORTURE_QEMU_CMD="$TORTURE_QEMU_CMD"; export TORTURE_QEMU_CMD
323 TORTURE_QEMU_INTERACTIVE="$TORTURE_QEMU_INTERACTIVE"; export TORTURE_QEMU_INTERACTIVE
324 TORTURE_QEMU_MAC="$TORTURE_QEMU_MAC"; export TORTURE_QEMU_MAC
325 TORTURE_QEMU_MEM="$TORTURE_QEMU_MEM"; export TORTURE_QEMU_MEM
326 TORTURE_SHUTDOWN_GRACE="$TORTURE_SHUTDOWN_GRACE"; export TORTURE_SHUTDOWN_GRACE
327 TORTURE_SUITE="$TORTURE_SUITE"; export TORTURE_SUITE
328 TORTURE_TRUST_MAKE="$TORTURE_TRUST_MAKE"; export TORTURE_TRUST_MAKE
331 mkdir -p "$resdir" || :
334 echo Results directory: $resdir/$ds
335 echo $scriptname $args
336 touch $resdir/$ds/log
337 echo $scriptname $args >> $resdir/$ds/log
338 echo ${TORTURE_SUITE} > $resdir/$ds/TORTURE_SUITE
339 pwd > $resdir/$ds/testid.txt
342 git status >> $resdir/$ds/testid.txt
343 git rev-parse HEAD >> $resdir/$ds/testid.txt
344 git diff HEAD >> $resdir/$ds/testid.txt
347 awk < $T/cfgcpu.pack \
348 -v TORTURE_BUILDONLY="$TORTURE_BUILDONLY" \
349 -v CONFIGDIR="$CONFIGFRAG/" \
352 -v jitter="$jitter" \
355 -v TORTURE_QEMU_ARG="$TORTURE_QEMU_ARG" \
356 -v TORTURE_BOOTARGS="$TORTURE_BOOTARGS" \
367 # Dump out the scripting required to run one test batch.
368 function dump(first, pastlast, batchnum)
370 print "echo ----Start batch " batchnum ": `date` | tee -a " rd "log";
373 for (j = first; j < pastlast; j++) {
374 builddir=KVM "/b" j - first + 1
376 if (cfrep[cf[j]] == "") {
381 cfr[jn] = cf[j] "." cfrep[cf[j]];
383 if (cpusr[jn] > ncpus && ncpus != 0)
387 print "echo ", cfr[jn], cpusr[jn] ovf ": Starting build. `date` | tee -a " rd "log";
388 print "rm -f " builddir ".*";
389 print "touch " builddir ".wait";
390 print "mkdir " rd cfr[jn] " || :";
391 print "kvm-test-1-run.sh " CONFIGDIR cf[j], builddir, rd cfr[jn], dur " \"" TORTURE_QEMU_ARG "\" \"" TORTURE_BOOTARGS "\" > " rd cfr[jn] "/kvm-test-1-run.sh.out 2>&1 &"
392 print "echo ", cfr[jn], cpusr[jn] ovf ": Waiting for build to complete. `date` | tee -a " rd "log";
393 print "while test -f " builddir ".wait"
397 print "echo ", cfr[jn], cpusr[jn] ovf ": Build complete. `date` | tee -a " rd "log";
400 for (j = 1; j < jn; j++) {
402 print "rm -f " builddir ".ready"
403 print "if test -f \"" rd cfr[j] "/builtkernel\""
405 print "\techo ----", cfr[j], cpusr[j] ovf ": Kernel present. `date` | tee -a " rd "log";
406 print "\tneedqemurun=1"
411 if (ja[1] == -1 && ncpus == 0)
413 else if (ja[1] == -1)
417 if (TORTURE_BUILDONLY && njitter != 0) {
419 print "echo Build-only run, so suppressing jitter | tee -a " rd "log"
421 if (TORTURE_BUILDONLY) {
424 print "if test -n \"$needqemurun\""
426 print "\techo ---- Starting kernels. `date` | tee -a " rd "log";
427 for (j = 0; j < njitter; j++)
428 print "\tjitter.sh " j " " dur " " ja[2] " " ja[3] "&"
430 print "\techo ---- All kernel runs complete. `date` | tee -a " rd "log";
433 print "\techo ---- No kernel runs. `date` | tee -a " rd "log";
435 for (j = 1; j < jn; j++) {
437 print "echo ----", cfr[j], cpusr[j] ovf ": Build/run results: | tee -a " rd "log";
438 print "cat " rd cfr[j] "/kvm-test-1-run.sh.out | tee -a " rd "log";
448 # Each pass through the following loop considers one test.
449 for (i = 0; i < njobs; i++) {
451 # Sequential test specified, each test its own batch.
452 dump(i, i + 1, batchnum);
455 } else if (nc < cpus[i] && i != 0) {
456 # Out of CPUs, dump out a batch.
457 dump(first, i, batchnum);
462 # Account for the CPUs needed by the current test.
465 # Dump the last batch.
467 dump(first, i, batchnum);
470 cat << ___EOF___ >> $T/script
473 echo " --- `date` Test summary:"
474 echo Results directory: $resdir/$ds
475 kvm-recheck.sh $resdir/$ds
478 if test "$dryrun" = script
482 elif test "$dryrun" = sched
484 # Extract the test run schedule from the script.
485 egrep 'Start batch|Starting build\.' $T/script |
487 sed -e 's/:.*$//' -e 's/^echo //'
490 # Not a dryrun, so run the script.
494 # Tracing: trace_event=rcu:rcu_grace_period,rcu:rcu_future_grace_period,rcu:rcu_grace_period_init,rcu:rcu_nocb_wake,rcu:rcu_preempt_task,rcu:rcu_unlock_preempted_task,rcu:rcu_quiescent_state_report,rcu:rcu_fqs,rcu:rcu_callback,rcu:rcu_kfree_callback,rcu:rcu_batch_start,rcu:rcu_invoke_callback,rcu:rcu_invoke_kfree_callback,rcu:rcu_batch_end,rcu:rcu_torture_read,rcu:rcu_barrier
495 # Function-graph tracing: ftrace=function_graph ftrace_graph_filter=sched_setaffinity,migration_cpu_stop
496 # Also --kconfig "CONFIG_FUNCTION_TRACER=y CONFIG_FUNCTION_GRAPH_TRACER=y"