1llvm-symbolizer - convert addresses into source code locations 2============================================================== 3 4SYNOPSIS 5-------- 6 7:program:`llvm-symbolizer` [options] 8 9DESCRIPTION 10----------- 11 12:program:`llvm-symbolizer` reads object file names and addresses from standard 13input and prints corresponding source code locations to standard output. 14If object file is specified in command line, :program:`llvm-symbolizer` reads 15only addresses from standard input. This 16program uses debug info sections and symbol table in the object files. 17 18EXAMPLE 19-------- 20 21.. code-block:: console 22 23 $ cat addr.txt 24 a.out 0x4004f4 25 /tmp/b.out 0x400528 26 /tmp/c.so 0x710 27 /tmp/mach_universal_binary:i386 0x1f84 28 /tmp/mach_universal_binary:x86_64 0x100000f24 29 $ llvm-symbolizer < addr.txt 30 main 31 /tmp/a.cc:4 32 33 f(int, int) 34 /tmp/b.cc:11 35 36 h_inlined_into_g 37 /tmp/header.h:2 38 g_inlined_into_f 39 /tmp/header.h:7 40 f_inlined_into_main 41 /tmp/source.cc:3 42 main 43 /tmp/source.cc:8 44 45 _main 46 /tmp/source_i386.cc:8 47 48 _main 49 /tmp/source_x86_64.cc:8 50 $ cat addr2.txt 51 0x4004f4 52 0x401000 53 $ llvm-symbolizer -obj=a.out < addr2.txt 54 main 55 /tmp/a.cc:4 56 57 foo(int) 58 /tmp/a.cc:12 59 60OPTIONS 61------- 62 63.. option:: -obj 64 65 Path to object file to be symbolized. 66 67.. option:: -functions=[none|short|linkage] 68 69 Specify the way function names are printed (omit function name, 70 print short function name, or print full linkage name, respectively). 71 Defaults to ``linkage``. 72 73.. option:: -use-symbol-table 74 75 Prefer function names stored in symbol table to function names 76 in debug info sections. Defaults to true. 77 78.. option:: -demangle 79 80 Print demangled function names. Defaults to true. 81 82.. option:: -inlining 83 84 If a source code location is in an inlined function, prints all the 85 inlnied frames. Defaults to true. 86 87.. option:: -default-arch 88 89 If a binary contains object files for multiple architectures (e.g. it is a 90 Mach-O universal binary), symbolize the object file for a given architecture. 91 You can also specify architecture by writing ``binary_name:arch_name`` in the 92 input (see example above). If architecture is not specified in either way, 93 address will not be symbolized. Defaults to empty string. 94 95.. option:: -dsym-hint=<path/to/file.dSYM> 96 97 (Darwin-only flag). If the debug info for a binary isn't present in the default 98 location, look for the debug info at the .dSYM path provided via the 99 ``-dsym-hint`` flag. This flag can be used multiple times. 100 101 102EXIT STATUS 103----------- 104 105:program:`llvm-symbolizer` returns 0. Other exit codes imply internal program error. 106