2 .\" Man page generated from reStructuredText.
4 .TH "LLVM-SYMBOLIZER" "1" "2016-03-03" "3.8" "LLVM"
6 llvm-symbolizer \- convert addresses into source code locations
8 .nr rst2man-indent-level 0
12 level \\n[rst2man-indent-level]
13 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
20 .\" .rstReportMargin pre:
22 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
23 . nr rst2man-indent-level +1
24 .\" .rstReportMargin post:
28 .\" indent \\n[an-margin]
29 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 .nr rst2man-indent-level -1
31 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
32 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
36 \fBllvm\-symbolizer\fP [options]
39 \fBllvm\-symbolizer\fP reads object file names and addresses from standard
40 input and prints corresponding source code locations to standard output.
41 If object file is specified in command line, \fBllvm\-symbolizer\fP
42 processes only addresses from standard input, the rest is output verbatim.
43 This program uses debug info sections and symbol table in the object files.
54 /tmp/mach_universal_binary:i386 0x1f84
55 /tmp/mach_universal_binary:x86_64 0x100000f24
56 $ llvm\-symbolizer < addr.txt
76 /tmp/source_x86_64.cc:8
80 $ llvm\-symbolizer \-obj=a.out < addr2.txt
88 $llvm\-symbolizer \-inlining \-print\-address \-pretty\-print \-obj=addr.exe < addr.txt
89 0x40054d: inc at /tmp/x.c:3:3
90 (inlined by) main at /tmp/x.c:9:0
91 $llvm\-symbolizer \-inlining \-pretty\-print \-obj=addr.exe < addr.txt
93 (inlined by) main at /tmp/x.c:9:0
102 Path to object file to be symbolized.
106 .B \-functions=[none|short|linkage]
107 Specify the way function names are printed (omit function name,
108 print short function name, or print full linkage name, respectively).
109 Defaults to \fBlinkage\fP\&.
113 .B \-use\-symbol\-table
114 Prefer function names stored in symbol table to function names
115 in debug info sections. Defaults to true.
120 Print demangled function names. Defaults to true.
125 If a source code location is in an inlined function, prints all the
126 inlnied frames. Defaults to true.
131 If a binary contains object files for multiple architectures (e.g. it is a
132 Mach\-O universal binary), symbolize the object file for a given architecture.
133 You can also specify architecture by writing \fBbinary_name:arch_name\fP in the
134 input (see example above). If architecture is not specified in either way,
135 address will not be symbolized. Defaults to empty string.
139 .B \-dsym\-hint=<path/to/file.dSYM>
140 (Darwin\-only flag). If the debug info for a binary isn\(aqt present in the default
141 location, look for the debug info at the .dSYM path provided via the
142 \fB\-dsym\-hint\fP flag. This flag can be used multiple times.
147 Print address before the source code location. Defaults to false.
152 Print human readable output. If \fB\-inlining\fP is specified, enclosing scope is
153 prefixed by (inlined by). Refer to listed examples.
157 \fBllvm\-symbolizer\fP returns 0. Other exit codes imply internal program error.
159 Maintained by The LLVM Team (http://llvm.org/).
161 2003-2016, LLVM Project
162 .\" Generated by docutils manpage writer.