2 # SPDX-License-Identifier: GPL-2.0
3 # (c) 2014, Sasha Levin <sasha.levin@oracle.com>
8 echo " $0 -r <release>"
9 echo " $0 [<vmlinux> [<base_path>|auto [<modules_path>]]]"
13 # Try to find a Rust demangler
14 if type llvm-cxxfilt
>/dev
/null
2>&1 ; then
16 elif type c
++filt
>/dev
/null
2>&1 ; then
22 if [[ -z ${LLVM:-} ]]; then
23 UTIL_PREFIX
=${CROSS_COMPILE:-}
26 if [[ ${LLVM} == */ ]]; then
27 UTIL_PREFIX
=${LLVM}${UTIL_PREFIX}
28 elif [[ ${LLVM} == -* ]]; then
33 READELF
=${UTIL_PREFIX}readelf
${UTIL_SUFFIX}
34 ADDR2LINE
=${UTIL_PREFIX}addr2line
${UTIL_SUFFIX}
35 NM
=${UTIL_PREFIX}nm
${UTIL_SUFFIX}
37 if [[ $1 == "-h" ]] ; then
40 elif [[ $1 == "-r" ]] ; then
46 for fn
in {,/usr
/lib
/debug
}/boot
/vmlinux-
$release{,.debug
} /lib
/modules
/$release{,/build
}/vmlinux
; do
47 if [ -e "$fn" ] ; then
53 if [[ $vmlinux == "" ]] ; then
54 echo "ERROR! vmlinux image for release $release is not found" >&2
65 # Can we use debuginfod-find?
66 if type debuginfod-find
>/dev
/null
2>&1 ; then
70 if [[ $vmlinux == "" && -z $debuginfod ]] ; then
71 echo "ERROR! vmlinux image must be specified" >&2
77 declare aarray_support
=true
78 declare -A cache
2>/dev
/null
79 if [[ $?
!= 0 ]]; then
86 if [[ -n $debuginfod ]] ; then
87 if [[ -n $modbuildid ]] ; then
88 debuginfod-find debuginfo
$modbuildid && return
91 # Only using debuginfod so don't try to find vmlinux module path
92 if [[ $debuginfod == "only" ]] ; then
97 if [ -z $release ] ; then
98 release
=$
(gdb
-ex 'print init_uts_ns.name.release' -ex 'quit' -quiet -batch "$vmlinux" 2>/dev
/null |
sed -n 's/\$1 = "\(.*\)".*/\1/p')
100 if [ -n "${release}" ] ; then
101 release_dirs
="/usr/lib/debug/lib/modules/$release /lib/modules/$release"
104 found_without_debug_info
=false
105 for dir
in "$modpath" "$(dirname "$vmlinux")" ${release_dirs}; do
106 if [ -n "${dir}" ] && [ -e "${dir}" ]; then
107 for fn
in $
(find "$dir" -name "${module//_/[-_]}.ko*") ; do
108 if ${READELF} -WS "$fn" |
grep -qwF .debug_line
; then
112 found_without_debug_info
=true
117 if [[ ${found_without_debug_info} == true
]]; then
118 echo "WARNING! No debugging info in module ${module}, rebuild with DEBUG_KERNEL and DEBUG_INFO" >&2
120 echo "WARNING! Cannot find .ko for module ${module}, please pass a valid module path" >&2
127 # The structure of symbol at this point is:
128 # ([name]+[offset]/[total length])
131 # do_basic_setup+0x9c/0xbf
133 if [[ $module == "" ]] ; then
134 local objfile
=$vmlinux
135 elif [[ $aarray_support == true
&& "${modcache[$module]+isset}" == "isset" ]]; then
136 local objfile
=${modcache[$module]}
138 local objfile
=$
(find_module
)
139 if [[ $objfile == "" ]] ; then
142 if [[ $aarray_support == true
]]; then
143 modcache
[$module]=$objfile
147 # Remove the englobing parenthesis
153 if [[ $symbol == *:* ]] ; then
154 segment
=${symbol%%:*}:
158 # Strip the symbol name so that we could look it up
159 local name
=${symbol%+*}
161 # Use 'nm vmlinux' to figure out the base address of said symbol.
162 # It's actually faster to call it every time than to load it
164 if [[ $aarray_support == true
&& "${cache[$module,$name]+isset}" == "isset" ]]; then
165 local base_addr
=${cache[$module,$name]}
167 local base_addr
=$
(${NM} "$objfile" 2>/dev
/null |
awk '$3 == "'$name'" && ($2 == "t" || $2 == "T") {print $1; exit}')
168 if [[ $base_addr == "" ]] ; then
172 if [[ $aarray_support == true
]]; then
173 cache
[$module,$name]="$base_addr"
176 # Let's start doing the math to get the exact address into the
177 # symbol. First, strip out the symbol total length.
178 local expr=${symbol%/*}
180 # Now, replace the symbol name with the base address we found
182 expr=${expr/$name/0x$base_addr}
184 # Evaluate it to find the actual address
186 local address
=$
(printf "%x\n" "$expr")
188 # Pass it to addr2line to get filename and line number
189 # Could get more than one result
190 if [[ $aarray_support == true
&& "${cache[$module,$address]+isset}" == "isset" ]]; then
191 local code
=${cache[$module,$address]}
193 local code
=$
(${ADDR2LINE} -i -e "$objfile" "$address" 2>/dev
/null
)
194 if [[ $aarray_support == true
]]; then
195 cache
[$module,$address]=$code
199 # addr2line doesn't return a proper error code if it fails, so
200 # we detect it using the value it prints so that we could preserve
201 # the offset/size into the function and bail out
202 if [[ $code == "??:0" ]]; then
206 # Strip out the base of the path on each line
207 code
=$
(while read -r line
; do echo "${line#$basepath/}"; done <<< "$code")
209 # In the case of inlines, move everything to same line
210 code
=${code//$'\n'/' '}
212 # Demangle if the name looks like a Rust symbol and if
213 # we got a Rust demangler
214 if [[ $name =~ ^_R
&& $cppfilt != "" ]] ; then
215 name
=$
("$cppfilt" "$cppfilt_opts" "$name")
218 # Replace old address with pretty line numbers
219 symbol
="$segment$name ($code)"
222 debuginfod_get_vmlinux
() {
223 local vmlinux_buildid
=${1##* }
225 if [[ $vmlinux != "" ]]; then
229 if [[ $vmlinux_buildid =~ ^
[0-9a-f]+ ]]; then
230 vmlinux
=$
(debuginfod-find debuginfo
$vmlinux_buildid)
231 if [[ $?
-ne 0 ]] ; then
232 echo "ERROR! vmlinux image not found via debuginfod-find" >&2
238 echo "ERROR! Build ID for vmlinux not found. Try passing -r or specifying vmlinux" >&2
244 local scripts
=`dirname "${BASH_SOURCE[0]}"`
246 echo "$1" |
$scripts/decodecode
250 if [[ $basepath == "auto" && $vmlinux != "" ]] ; then
252 symbol
="kernel_init+0x0/0x0"
254 basepath
=${symbol#kernel_init (}
255 basepath
=${basepath%/init/main.c:*)}
261 read -a words
<<<"$1"
263 # Remove hex numbers. Do it ourselves until it happens in the
266 # We need to know the index of the last element before we
267 # remove elements because arrays are sparse
268 local last
=$
(( ${#words[@]} - 1 ))
270 for i
in "${!words[@]}"; do
272 if [[ ${words[$i]} =~ \
[\
<([^
]]+)\
>\
] ]]; then
276 # Format timestamps with tabs
277 if [[ ${words[$i]} == \
[ && ${words[$i+1]} == *\
] ]]; then
279 words
[$i+1]=$
(printf "[%13s\n" "${words[$i+1]}")
283 if [[ ${words[$last]} =~ ^
[0-9a-f]+\
] ]]; then
284 words
[$last-1]="${words[$last-1]} ${words[$last]}"
286 last
=$
(( $last - 1 ))
289 if [[ ${words[$last]} =~ \
[([^
]]+)\
] ]]; then
290 module
=${words[$last]}
291 # some traces format is "(%pS)", which like "(foo+0x0/0x1 [bar])"
292 # so $module may like "[bar])". Strip the right parenthesis firstly
296 modbuildid
=${module#* }
298 if [[ $modbuildid == $module ]]; then
301 symbol
=${words[$last-1]}
304 # The symbol is the last element, process it
305 symbol
=${words[$last]}
311 parse_symbol
# modifies $symbol
313 # Add up the line number to the symbol
314 if [[ -z ${module} ]]
316 echo "${words[@]}" "$symbol"
318 echo "${words[@]}" "$symbol $module"
323 # Strip unexpected carriage return at end of line
326 # Let's see if we have an address in the line
327 if [[ $line =~ \
[\
<([^
]]+)\
>\
] ]] ||
328 [[ $line =~
[^
+\
]+\
+0x
[0-9a-f]+/0x
[0-9a-f]+ ]]; then
329 # Translate address to line numbers
332 elif [[ $line == *Code
:* ]]; then
334 # Is it a version line?
335 elif [[ -n $debuginfod && $line =~ PID
:\
[0-9]+\ Comm
: ]]; then
336 debuginfod_get_vmlinux
"$line"
338 # Nothing special in this line, show it as is