linux-yocto/scripts/faddr2line
Peter Zijlstra (Intel) 689135f0ed scripts/faddr2line: make the new code listing format optional
Commit 6870c0165f ("scripts/faddr2line: show the code context")
radically altered the output format of the faddr2line tool.  And while
the new list output format might have merit it broke my vim usage and
was hard to read.

Make the new format optional; using a '--list' argument and attempt to
make the output slightly easier to read by adding a little whitespace to
separate the different files and explicitly mark the line in question.

Cc: Changbin Du <changbin.du@intel.com>
Fixes: 6870c0165f ("scripts/faddr2line: show the code context")
Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org>
Signed-off-by: Josh Poimboeuf <jpoimboe@redhat.com>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2018-06-05 09:04:37 -07:00

6.2 KiB
Executable File

#!/bin/bash

SPDX-License-Identifier: GPL-2.0

Translate stack dump function offsets.

addr2line doesn't work with KASLR addresses. This works similarly to

addr2line, but instead takes the 'func+0x123' format as input:

$ ./scripts/faddr2line ~/k/vmlinux meminfo_proc_show+0x5/0x568

meminfo_proc_show+0x5/0x568:

meminfo_proc_show at fs/proc/meminfo.c:27

If the address is part of an inlined function, the full inline call chain is

printed:

$ ./scripts/faddr2line ~/k/vmlinux native_write_msr+0x6/0x27

native_write_msr+0x6/0x27:

arch_static_branch at arch/x86/include/asm/msr.h:121

(inlined by) static_key_false at include/linux/jump_label.h:125

(inlined by) native_write_msr at arch/x86/include/asm/msr.h:125

The function size after the '/' in the input is optional, but recommended.

It's used to help disambiguate any duplicate symbol names, which can occur

rarely. If the size is omitted for a duplicate symbol then it's possible for

multiple code sites to be printed:

$ ./scripts/faddr2line ~/k/vmlinux raw_ioctl+0x5

raw_ioctl+0x5/0x20:

raw_ioctl at drivers/char/raw.c:122

raw_ioctl+0x5/0xb1:

raw_ioctl at net/ipv4/raw.c:876

Multiple addresses can be specified on a single command line:

$ ./scripts/faddr2line ~/k/vmlinux type_show+0x10/45 free_reserved_area+0x90

type_show+0x10/0x2d:

type_show at drivers/video/backlight/backlight.c:213

free_reserved_area+0x90/0x123:

free_reserved_area at mm/page_alloc.c:6429 (discriminator 2)

set -o errexit set -o nounset

READELF="${CROSS_COMPILE:-}readelf" ADDR2LINE="${CROSS_COMPILE:-}addr2line" SIZE="${CROSS_COMPILE:-}size" NM="${CROSS_COMPILE:-}nm"

command -v awk >/dev/null 2>&1 || die "awk isn't installed" command -v ${READELF} >/dev/null 2>&1 || die "readelf isn't installed" command -v ${ADDR2LINE} >/dev/null 2>&1 || die "addr2line isn't installed" command -v ${SIZE} >/dev/null 2>&1 || die "size isn't installed" command -v ${NM} >/dev/null 2>&1 || die "nm isn't installed"

usage() { echo "usage: faddr2line [--list]