2 # SPDX-License-Identifier: GPL-2.0
3 # (c) 2014, Sasha Levin <sasha.levin@oracle.com>
8 echo " $0 -r <release> | <vmlinux> [<base path>|auto] [<modules path>]"
11 # Try to find a Rust demangler
12 if type llvm-cxxfilt >/dev/null 2>&1 ; then
14 elif type c++filt >/dev/null 2>&1 ; then
19 if [[ $1 == "-r" ]] ; then
25 for fn in {,/usr/lib/debug}/boot/vmlinux-$release{,.debug} /lib/modules/$release{,/build}/vmlinux ; do
26 if [ -e "$fn" ] ; then
32 if [[ $vmlinux == "" ]] ; then
33 echo "ERROR! vmlinux image for release $release is not found" >&2
44 # Can we use debuginfod-find?
45 if type debuginfod-find >/dev/null 2>&1 ; then
49 if [[ $vmlinux == "" && -z $debuginfod ]] ; then
50 echo "ERROR! vmlinux image must be specified" >&2
56 declare aarray_support=true
57 declare -A cache 2>/dev/null
58 if [[ $? != 0 ]]; then
65 if [[ -n $debuginfod ]] ; then
66 if [[ -n $modbuildid ]] ; then
67 debuginfod-find debuginfo $modbuildid && return
70 # Only using debuginfod so don't try to find vmlinux module path
71 if [[ $debuginfod == "only" ]] ; then
76 if [[ "$modpath" != "" ]] ; then
77 for fn in $(find "$modpath" -name "${module//_/[-_]}.ko*") ; do
78 if readelf -WS "$fn" | grep -qwF .debug_line ; then
86 modpath=$(dirname "$vmlinux")
89 if [[ $release == "" ]] ; then
90 release=$(gdb -ex 'print init_uts_ns.name.release' -ex 'quit' -quiet -batch "$vmlinux" 2>/dev/null | sed -n 's/\$1 = "\(.*\)".*/\1/p')
93 for dn in {/usr/lib/debug,}/lib/modules/$release ; do
94 if [ -e "$dn" ] ; then
105 # The structure of symbol at this point is:
106 # ([name]+[offset]/[total length])
109 # do_basic_setup+0x9c/0xbf
111 if [[ $module == "" ]] ; then
112 local objfile=$vmlinux
113 elif [[ $aarray_support == true && "${modcache[$module]+isset}" == "isset" ]]; then
114 local objfile=${modcache[$module]}
116 local objfile=$(find_module)
117 if [[ $objfile == "" ]] ; then
118 echo "WARNING! Modules path isn't set, but is needed to parse this symbol" >&2
121 if [[ $aarray_support == true ]]; then
122 modcache[$module]=$objfile
126 # Remove the englobing parenthesis
132 if [[ $symbol == *:* ]] ; then
133 segment=${symbol%%:*}:
137 # Strip the symbol name so that we could look it up
138 local name=${symbol%+*}
140 # Use 'nm vmlinux' to figure out the base address of said symbol.
141 # It's actually faster to call it every time than to load it
143 if [[ $aarray_support == true && "${cache[$module,$name]+isset}" == "isset" ]]; then
144 local base_addr=${cache[$module,$name]}
146 local base_addr=$(nm "$objfile" 2>/dev/null | awk '$3 == "'$name'" && ($2 == "t" || $2 == "T") {print $1; exit}')
147 if [[ $base_addr == "" ]] ; then
151 if [[ $aarray_support == true ]]; then
152 cache[$module,$name]="$base_addr"
155 # Let's start doing the math to get the exact address into the
156 # symbol. First, strip out the symbol total length.
157 local expr=${symbol%/*}
159 # Now, replace the symbol name with the base address we found
161 expr=${expr/$name/0x$base_addr}
163 # Evaluate it to find the actual address
165 local address=$(printf "%x\n" "$expr")
167 # Pass it to addr2line to get filename and line number
168 # Could get more than one result
169 if [[ $aarray_support == true && "${cache[$module,$address]+isset}" == "isset" ]]; then
170 local code=${cache[$module,$address]}
172 local code=$(${CROSS_COMPILE}addr2line -i -e "$objfile" "$address" 2>/dev/null)
173 if [[ $aarray_support == true ]]; then
174 cache[$module,$address]=$code
178 # addr2line doesn't return a proper error code if it fails, so
179 # we detect it using the value it prints so that we could preserve
180 # the offset/size into the function and bail out
181 if [[ $code == "??:0" ]]; then
185 # Strip out the base of the path on each line
186 code=$(while read -r line; do echo "${line#$basepath/}"; done <<< "$code")
188 # In the case of inlines, move everything to same line
189 code=${code//$'\n'/' '}
191 # Demangle if the name looks like a Rust symbol and if
192 # we got a Rust demangler
193 if [[ $name =~ ^_R && $cppfilt != "" ]] ; then
194 name=$("$cppfilt" "$cppfilt_opts" "$name")
197 # Replace old address with pretty line numbers
198 symbol="$segment$name ($code)"
201 debuginfod_get_vmlinux() {
202 local vmlinux_buildid=${1##* }
204 if [[ $vmlinux != "" ]]; then
208 if [[ $vmlinux_buildid =~ ^[0-9a-f]+ ]]; then
209 vmlinux=$(debuginfod-find debuginfo $vmlinux_buildid)
210 if [[ $? -ne 0 ]] ; then
211 echo "ERROR! vmlinux image not found via debuginfod-find" >&2
217 echo "ERROR! Build ID for vmlinux not found. Try passing -r or specifying vmlinux" >&2
223 local scripts=`dirname "${BASH_SOURCE[0]}"`
225 echo "$1" | $scripts/decodecode
229 if [[ $basepath == "auto" && $vmlinux != "" ]] ; then
231 symbol="kernel_init+0x0/0x0"
233 basepath=${symbol#kernel_init (}
234 basepath=${basepath%/init/main.c:*)}
240 read -a words <<<"$1"
242 # Remove hex numbers. Do it ourselves until it happens in the
245 # We need to know the index of the last element before we
246 # remove elements because arrays are sparse
247 local last=$(( ${#words[@]} - 1 ))
249 for i in "${!words[@]}"; do
251 if [[ ${words[$i]} =~ \[\<([^]]+)\>\] ]]; then
255 # Format timestamps with tabs
256 if [[ ${words[$i]} == \[ && ${words[$i+1]} == *\] ]]; then
258 words[$i+1]=$(printf "[%13s\n" "${words[$i+1]}")
262 if [[ ${words[$last]} =~ ^[0-9a-f]+\] ]]; then
263 words[$last-1]="${words[$last-1]} ${words[$last]}"
265 last=$(( $last - 1 ))
268 if [[ ${words[$last]} =~ \[([^]]+)\] ]]; then
269 module=${words[$last]}
272 modbuildid=${module#* }
274 if [[ $modbuildid == $module ]]; then
277 symbol=${words[$last-1]}
280 # The symbol is the last element, process it
281 symbol=${words[$last]}
287 parse_symbol # modifies $symbol
289 # Add up the line number to the symbol
290 echo "${words[@]}" "$symbol $module"
294 # Let's see if we have an address in the line
295 if [[ $line =~ \[\<([^]]+)\>\] ]] ||
296 [[ $line =~ [^+\ ]+\+0x[0-9a-f]+/0x[0-9a-f]+ ]]; then
297 # Translate address to line numbers
300 elif [[ $line == *Code:* ]]; then
302 # Is it a version line?
303 elif [[ -n $debuginfod && $line =~ PID:\ [0-9]+\ Comm: ]]; then
304 debuginfod_get_vmlinux "$line"
306 # Nothing special in this line, show it as is