1 llvm-symbolizer - convert addresses into source code locations
2 ==============================================================
7 :program:`llvm-symbolizer` [options]
12 :program:`llvm-symbolizer` reads object file names and addresses from standard
13 input and prints corresponding source code locations to standard output.
14 If object file is specified in command line, :program:`llvm-symbolizer` reads
15 only addresses from standard input. This
16 program uses debug info sections and symbol table in the object files.
21 .. code-block:: console
27 /tmp/mach_universal_binary:i386 0x1f84
28 /tmp/mach_universal_binary:x86_64 0x100000f24
29 $ llvm-symbolizer < addr.txt
49 /tmp/source_x86_64.cc:8
53 $ llvm-symbolizer -obj=a.out < addr2.txt
64 Path to object file to be symbolized.
66 .. option:: -functions
68 Print function names as well as source file/line locations. Defaults to true.
70 .. option:: -use-symbol-table
72 Prefer function names stored in symbol table to function names
73 in debug info sections. Defaults to true.
77 Print demangled function names. Defaults to true.
81 If a source code location is in an inlined function, prints all the
82 inlnied frames. Defaults to true.
84 .. option:: -default-arch
86 If a binary contains object files for multiple architectures (e.g. it is a
87 Mach-O universal binary), symbolize the object file for a given architecture.
88 You can also specify architecture by writing ``binary_name:arch_name`` in the
89 input (see example above). If architecture is not specified in either way,
90 address will not be symbolized. Defaults to empty string.
95 :program:`llvm-symbolizer` returns 0. Other exit codes imply internal program error.