1 llvm-symbolizer - convert addresses into source code locations 2 ============================================================== 3 4 SYNOPSIS 5 -------- 6 7 :program:`llvm-symbolizer` [options] 8 9 DESCRIPTION 10 ----------- 11 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` 15 processes only addresses from standard input, the rest is output verbatim. 16 This program uses debug info sections and symbol table in the object files. 17 18 EXAMPLE 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 $cat addr.txt 60 0x40054d 61 $llvm-symbolizer -inlining -print-address -pretty-print -obj=addr.exe < addr.txt 62 0x40054d: inc at /tmp/x.c:3:3 63 (inlined by) main at /tmp/x.c:9:0 64 $llvm-symbolizer -inlining -pretty-print -obj=addr.exe < addr.txt 65 inc at /tmp/x.c:3:3 66 (inlined by) main at /tmp/x.c:9:0 67 68 OPTIONS 69 ------- 70 71 .. option:: -obj 72 73 Path to object file to be symbolized. 74 75 .. option:: -functions=[none|short|linkage] 76 77 Specify the way function names are printed (omit function name, 78 print short function name, or print full linkage name, respectively). 79 Defaults to ``linkage``. 80 81 .. option:: -use-symbol-table 82 83 Prefer function names stored in symbol table to function names 84 in debug info sections. Defaults to true. 85 86 .. option:: -demangle 87 88 Print demangled function names. Defaults to true. 89 90 .. option:: -inlining 91 92 If a source code location is in an inlined function, prints all the 93 inlnied frames. Defaults to true. 94 95 .. option:: -default-arch 96 97 If a binary contains object files for multiple architectures (e.g. it is a 98 Mach-O universal binary), symbolize the object file for a given architecture. 99 You can also specify architecture by writing ``binary_name:arch_name`` in the 100 input (see example above). If architecture is not specified in either way, 101 address will not be symbolized. Defaults to empty string. 102 103 .. option:: -dsym-hint=<path/to/file.dSYM> 104 105 (Darwin-only flag). If the debug info for a binary isn't present in the default 106 location, look for the debug info at the .dSYM path provided via the 107 ``-dsym-hint`` flag. This flag can be used multiple times. 108 109 .. option:: -print-address 110 111 Print address before the source code location. Defaults to false. 112 113 .. option:: -pretty-print 114 115 Print human readable output. If ``-inlining`` is specified, enclosing scope is 116 prefixed by (inlined by). Refer to listed examples. 117 118 EXIT STATUS 119 ----------- 120 121 :program:`llvm-symbolizer` returns 0. Other exit codes imply internal program error. 122
