DragonFly On-Line Manual Pages

Search: Section:  


LLVM-SYMBOLIZER(1)                   LLVM                   LLVM-SYMBOLIZER(1)

NAME

llvm-symbolizer - convert addresses into source code locations

SYNOPSIS

llvm-symbolizer [options]

DESCRIPTION

llvm-symbolizer reads object file names and addresses from standard input and prints corresponding source code locations to standard output. If object file is specified in command line, llvm-symbolizer processes only addresses from standard input, the rest is output verbatim. This program uses debug info sections and symbol table in the object files.

EXAMPLE

$ cat addr.txt a.out 0x4004f4 /tmp/b.out 0x400528 /tmp/c.so 0x710 /tmp/mach_universal_binary:i386 0x1f84 /tmp/mach_universal_binary:x86_64 0x100000f24 $ llvm-symbolizer < addr.txt main /tmp/a.cc:4 f(int, int) /tmp/b.cc:11 h_inlined_into_g /tmp/header.h:2 g_inlined_into_f /tmp/header.h:7 f_inlined_into_main /tmp/source.cc:3 main /tmp/source.cc:8 _main /tmp/source_i386.cc:8 _main /tmp/source_x86_64.cc:8 $ cat addr2.txt 0x4004f4 0x401000 $ llvm-symbolizer -obj=a.out < addr2.txt main /tmp/a.cc:4 foo(int) /tmp/a.cc:12 $cat addr.txt 0x40054d $llvm-symbolizer -inlining -print-address -pretty-print -obj=addr.exe < addr.txt 0x40054d: inc at /tmp/x.c:3:3 (inlined by) main at /tmp/x.c:9:0 $llvm-symbolizer -inlining -pretty-print -obj=addr.exe < addr.txt inc at /tmp/x.c:3:3 (inlined by) main at /tmp/x.c:9:0

OPTIONS

-obj, -exe, -e Path to object file to be symbolized. -functions=[none|short|linkage] Specify the way function names are printed (omit function name, print short function name, or print full linkage name, respectively). Defaults to linkage. -use-symbol-table Prefer function names stored in symbol table to function names in debug info sections. Defaults to true. -demangle, -C Print demangled function names. Defaults to true. -inlining If a source code location is in an inlined function, prints all the inlnied frames. Defaults to true. -default-arch If a binary contains object files for multiple architectures (e.g. it is a Mach-O universal binary), symbolize the object file for a given architecture. You can also specify architecture by writing binary_name:arch_name in the input (see example above). If architecture is not specified in either way, address will not be symbolized. Defaults to empty string. -dsym-hint=<path/to/file.dSYM> (Darwin-only flag). If the debug info for a binary isn't present in the default location, look for the debug info at the .dSYM path provided via the -dsym-hint flag. This flag can be used multiple times. -print-address, -addresses, -a Print address before the source code location. Defaults to false. -pretty-print, -p Print human readable output. If -inlining is specified, enclosing scope is prefixed by (inlined by). Refer to listed examples.

EXIT STATUS

llvm-symbolizer returns 0. Other exit codes imply internal program error.

AUTHOR

Maintained by the LLVM Team (https://llvm.org/).

COPYRIGHT

2003-2020, LLVM Project 8 2020-02-22 LLVM-SYMBOLIZER(1)

Search: Section: