Debian Codegraph @

tools/debugging/kernel-chktaint

raw
1 #! /bin/sh
2 # SPDX-License-Identifier: GPL-2.0
3 #
4 # Randy Dunlap <[email protected]>, 2018
5 # Thorsten Leemhuis <[email protected]>, 2018
6
7 usage()
8 {
9 cat <<EOF
10 usage: ${0##*/}
11 ${0##*/} <int>
12
13 Call without parameters to decode /proc/sys/kernel/tainted.
14
15 Call with a positive integer as parameter to decode a value you
16 retrieved from /proc/sys/kernel/tainted on another system.
17
18 EOF
19 }
20
21 if [ "$1"x != "x" ]; then
22 if [ "$1"x == "--helpx" ] || [ "$1"x == "-hx" ] ; then
23 usage
24 exit 1
25 elif [ $1 -ge 0 ] 2>/dev/null ; then
26 taint=$1
27 else
28 echo "Error: Parameter '$1' not a positive integer. Aborting." >&2
29 exit 1
30 fi
31 else
32 TAINTFILE="/proc/sys/kernel/tainted"
33 if [ ! -r $TAINTFILE ]; then
34 echo "No file: $TAINTFILE"
35 exit
36 fi
37
38 taint=`cat $TAINTFILE`
39 fi
40
41 if [ $taint -eq 0 ]; then
42 echo "Kernel not Tainted"
43 exit
44 else
45 echo "Kernel is \"tainted\" for the following reasons:"
46 fi
47
48 T=$taint
49 out=
50
51 addout() {
52 out=$out$1
53 }
54
55 if [ `expr $T % 2` -eq 0 ]; then
56 addout "G"
57 else
58 addout "P"
59 echo " * proprietary module was loaded (#0)"
60 fi
61
62 T=`expr $T / 2`
63 if [ `expr $T % 2` -eq 0 ]; then
64 addout " "
65 else
66 addout "F"
67 echo " * module was force loaded (#1)"
68 fi
69
70 T=`expr $T / 2`
71 if [ `expr $T % 2` -eq 0 ]; then
72 addout " "
73 else
74 addout "S"
75 echo " * kernel running on an out of specification system (#2)"
76 fi
77
78 T=`expr $T / 2`
79 if [ `expr $T % 2` -eq 0 ]; then
80 addout " "
81 else
82 addout "R"
83 echo " * module was force unloaded (#3)"
84 fi
85
86 T=`expr $T / 2`
87 if [ `expr $T % 2` -eq 0 ]; then
88 addout " "
89 else
90 addout "M"
91 echo " * processor reported a Machine Check Exception (MCE) (#4)"
92 fi
93
94 T=`expr $T / 2`
95 if [ `expr $T % 2` -eq 0 ]; then
96 addout " "
97 else
98 addout "B"
99 echo " * bad page referenced or some unexpected page flags (#5)"
100 fi
101
102 T=`expr $T / 2`
103 if [ `expr $T % 2` -eq 0 ]; then
104 addout " "
105 else
106 addout "U"
107 echo " * taint requested by userspace application (#6)"
108 fi
109
110 T=`expr $T / 2`
111 if [ `expr $T % 2` -eq 0 ]; then
112 addout " "
113 else
114 addout "D"
115 echo " * kernel died recently, i.e. there was an OOPS or BUG (#7)"
116 fi
117
118 T=`expr $T / 2`
119 if [ `expr $T % 2` -eq 0 ]; then
120 addout " "
121 else
122 addout "A"
123 echo " * an ACPI table was overridden by user (#8)"
124 fi
125
126 T=`expr $T / 2`
127 if [ `expr $T % 2` -eq 0 ]; then
128 addout " "
129 else
130 addout "W"
131 echo " * kernel issued warning (#9)"
132 fi
133
134 T=`expr $T / 2`
135 if [ `expr $T % 2` -eq 0 ]; then
136 addout " "
137 else
138 addout "C"
139 echo " * staging driver was loaded (#10)"
140 fi
141
142 T=`expr $T / 2`
143 if [ `expr $T % 2` -eq 0 ]; then
144 addout " "
145 else
146 addout "I"
147 echo " * workaround for bug in platform firmware applied (#11)"
148 fi
149
150 T=`expr $T / 2`
151 if [ `expr $T % 2` -eq 0 ]; then
152 addout " "
153 else
154 addout "O"
155 echo " * externally-built ('out-of-tree') module was loaded (#12)"
156 fi
157
158 T=`expr $T / 2`
159 if [ `expr $T % 2` -eq 0 ]; then
160 addout " "
161 else
162 addout "E"
163 echo " * unsigned module was loaded (#13)"
164 fi
165
166 T=`expr $T / 2`
167 if [ `expr $T % 2` -eq 0 ]; then
168 addout " "
169 else
170 addout "L"
171 echo " * soft lockup occurred (#14)"
172 fi
173
174 T=`expr $T / 2`
175 if [ `expr $T % 2` -eq 0 ]; then
176 addout " "
177 else
178 addout "K"
179 echo " * kernel has been live patched (#15)"
180 fi
181
182 T=`expr $T / 2`
183 if [ `expr $T % 2` -eq 0 ]; then
184 addout " "
185 else
186 addout "X"
187 echo " * auxiliary taint, defined for and used by distros (#16)"
188
189 fi
190
191 T=`expr $T / 2`
192 if [ `expr $T % 2` -eq 0 ]; then
193 addout " "
194 else
195 addout "T"
196 echo " * kernel was built with the struct randomization plugin (#17)"
197 fi
198
199 T=`expr $T / 2`
200 if [ `expr $T % 2` -eq 0 ]; then
201 addout " "
202 else
203 addout "N"
204 echo " * an in-kernel test (such as a KUnit test) has been run (#18)"
205 fi
206
207 T=`expr $T / 2`
208 if [ `expr $T % 2` -eq 0 ]; then
209 addout " "
210 else
211 addout "J"
212 echo " * fwctl's mutating debug interface was used (#19)"
213 fi
214 echo "Raw taint value as int/string: $taint/'$out'"
215
216 # report on any tainted loadable modules
217 [ "$1" = "" ] && [ -r /sys/module/ ] && \
218 cnt=`grep [A-Z] /sys/module/*/taint | wc -l` || cnt=0
219
220 if [ $cnt -ne 0 ]; then
221 echo
222 echo "Tainted modules:"
223 for dir in `ls /sys/module` ; do
224 if [ -r /sys/module/$dir/taint ]; then
225 modtnt=`cat /sys/module/$dir/taint`
226 [ "$modtnt" = "" ] || echo " * $dir ($modtnt)"
227 fi
228 done
229 fi
230
231 echo
232 echo "For a more detailed explanation of the various taint flags see"
233 echo " Documentation/admin-guide/tainted-kernels.rst in the Linux kernel sources"
234 echo " or https://kernel.org/doc/html/latest/admin-guide/tainted-kernels.html"
235 #EOF#