llvm-symbolizer - convert addresses into source code locations
llvm-symbolizer [options]
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 out-
put. If object file is specified in command line, llvm-symbolizer pro-
cesses 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 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, respec-
tively). Defaults to linkage.
-use-symbol-table
Prefer function names stored in symbol table to function names
in debug info sections. Defaults to true.
-demangle
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 architec-
ture 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
Print address before the source code location. Defaults to
false.
-pretty-print
Print human readable output. If -inlining is specified, enclos-
ing 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 (http://llvm.org/).
COPYRIGHT
2003-2016, LLVM Project
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+---------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+---------------------+
|Availability | developer/llvm/llvm |
+---------------+---------------------+
|Stability | Uncommitted |
+---------------+---------------------+
NOTES
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from
https://llvm.org//releases/6.0.0/llvm-6.0.0.src.tar.xz
Further information about this software can be found on the open source
community website at https://llvm.org/.
3.8 2016-07-10 LLVM-SYMBOLIZER(1)