3 # Run a herd test and check the result against a "Result:" comment within
4 # the litmus test. If the verification result does not match that specified
5 # in the litmus test, this script prints an error message prefixed with
6 # "^^^" and exits with a non-zero status. It also outputs verification
7 # results to a file whose name is that of the specified litmus test, but
8 # with ".out" appended.
11 # checklitmus.sh file.litmus
13 # The LINUX_HERD_OPTIONS environment variable may be used to specify
14 # arguments to herd, which default to "-conf linux-kernel.cfg". Thus,
15 # one would normally run this in the directory containing the memory model,
16 # specifying the pathname of the litmus test to check.
18 # This program is free software; you can redistribute it and/or modify
19 # it under the terms of the GNU General Public License as published by
20 # the Free Software Foundation; either version 2 of the License, or
21 # (at your option) any later version.
23 # This program is distributed in the hope that it will be useful,
24 # but WITHOUT ANY WARRANTY; without even the implied warranty of
25 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26 # GNU General Public License for more details.
28 # You should have received a copy of the GNU General Public License
29 # along with this program; if not, you can access it online at
30 # http://www.gnu.org/licenses/gpl-2.0.html.
32 # Copyright IBM Corporation, 2018
34 # Author: Paul E. McKenney <paulmck@linux.vnet.ibm.com>
37 herdoptions=${LINUX_HERD_OPTIONS--conf linux-kernel.cfg}
39 if test -f "$litmus" -a -r "$litmus"
43 echo ' --- ' error: \"$litmus\" is not a readable file
46 if grep -q '^ \* Result: ' $litmus
48 outcome=`grep -m 1 '^ \* Result: ' $litmus | awk '{ print $3 }'`
53 echo Herd options: $herdoptions > $litmus.out
54 /usr/bin/time herd7 -o ~/tmp $herdoptions $litmus >> $litmus.out 2>&1
55 grep "Herd options:" $litmus.out
56 grep '^Observation' $litmus.out
57 if grep -q '^Observation' $litmus.out
62 echo ' ^^^ Verification error'
63 echo ' ^^^ Verification error' >> $litmus.out 2>&1
66 if test "$outcome" = DEADLOCK
69 if grep '^Observation' $litmus.out | grep -q 'Never 0 0$'
73 echo " ^^^ Unexpected non-$outcome verification"
74 echo " ^^^ Unexpected non-$outcome verification" >> $litmus.out 2>&1
77 elif grep '^Observation' $litmus.out | grep -q $outcome || test "$outcome" = Maybe
81 echo " ^^^ Unexpected non-$outcome verification"
82 echo " ^^^ Unexpected non-$outcome verification" >> $litmus.out 2>&1
85 tail -2 $litmus.out | head -1