xref: /linux/tools/memory-model/scripts/runlitmus.sh (revision 6e7fd890f1d6ac83805409e9c346240de2705584)
1#!/bin/sh
2# SPDX-License-Identifier: GPL-2.0+
3#
4# Without the -hw argument, runs a herd7 test and outputs verification
5# results to a file whose name is that of the specified litmus test,
6# but with ".out" appended.
7#
8# If the --hw argument is specified, this script translates the .litmus
9# C-language file to the specified type of assembly and verifies that.
10# But in this case, litmus tests using complex synchronization (such as
11# locking, RCU, and SRCU) are cheerfully ignored.
12#
13# Either way, return the status of the herd7 command.
14#
15# Usage:
16#	runlitmus.sh file.litmus
17#
18# Run this in the directory containing the memory model, specifying the
19# pathname of the litmus test to check.  The caller is expected to have
20# properly set up the LKMM environment variables.
21#
22# Copyright IBM Corporation, 2019
23#
24# Author: Paul E. McKenney <paulmck@linux.ibm.com>
25
26litmus=$1
27if test -f "$litmus" -a -r "$litmus"
28then
29	:
30else
31	echo ' !!! ' error: \"$litmus\" is not a readable file
32	exit 255
33fi
34
35if test -z "$LKMM_HW_MAP_FILE" -o ! -e $LKMM_DESTDIR/$litmus.out
36then
37	# LKMM run
38	herdoptions=${LKMM_HERD_OPTIONS--conf linux-kernel.cfg}
39	echo Herd options: $herdoptions > $LKMM_DESTDIR/$litmus.out
40	/usr/bin/time $LKMM_TIMEOUT_CMD herd7 $herdoptions $litmus >> $LKMM_DESTDIR/$litmus.out 2>&1
41	ret=$?
42	if test -z "$LKMM_HW_MAP_FILE"
43	then
44		exit $ret
45	fi
46	echo " --- " Automatically generated LKMM output for '"'--hw $LKMM_HW_MAP_FILE'"' run
47fi
48
49# Hardware run
50
51T=/tmp/checklitmushw.sh.$$
52trap 'rm -rf $T' 0 2
53mkdir $T
54
55# Generate filenames
56mapfile="Linux2${LKMM_HW_MAP_FILE}.map"
57themefile="$T/${LKMM_HW_MAP_FILE}.theme"
58herdoptions="-model $LKMM_HW_CAT_FILE"
59hwlitmus=`echo $litmus | sed -e 's/\.litmus$/.litmus.'${LKMM_HW_MAP_FILE}'/'`
60hwlitmusfile=`echo $hwlitmus | sed -e 's,^.*/,,'`
61
62# Don't run on litmus tests with complex synchronization
63if ! scripts/simpletest.sh $litmus
64then
65	echo ' --- ' error: \"$litmus\" contains locking, RCU, or SRCU
66	exit 254
67fi
68
69# Generate the assembly code and run herd7 on it.
70gen_theme7 -n 10 -map $mapfile -call Linux.call > $themefile
71jingle7 -v -theme $themefile $litmus > $LKMM_DESTDIR/$hwlitmus 2> $T/$hwlitmusfile.jingle7.out
72if grep -q "Generated 0 tests" $T/$hwlitmusfile.jingle7.out
73then
74	echo ' !!! ' jingle7 failed, errors in $hwlitmus.err
75	cp $T/$hwlitmusfile.jingle7.out $LKMM_DESTDIR/$hwlitmus.err
76	exit 253
77fi
78/usr/bin/time $LKMM_TIMEOUT_CMD herd7 -unroll 0 $LKMM_DESTDIR/$hwlitmus > $LKMM_DESTDIR/$hwlitmus.out 2>&1
79
80exit $?
81