Lines Matching +full:15 +full:- +full:input
4 .nr rst2man-indent-level 0
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 .TH "LLVM-SYMBOLIZER" "1" "2023-05-24" "16" "LLVM"
32 llvm-symbolizer \- convert addresses into source code locations
35 \fBllvm\-symbolizer\fP [\fIoptions\fP] [\fIaddresses...\fP]
38 \fBllvm\-symbolizer\fP reads input names and addresses from the command\-line
41 \fI\%\-\-filter\-markup\fP\&.
43 If no address is specified on the command\-line, it reads the addresses from
44 standard input. If no input name is specified on the command\-line, but addresses
45 are, or if at any time an input value is not recognized, the input is simply
48 Input names can be specified together with the addresses either on standard
49 input or as positional arguments on the command\-line. By default, input names
55 A positional argument or standard input value can be preceded by \(dqDATA\(dq or
60 \fBllvm\-symbolizer\fP parses options from the environment variable
62 \fBLLVM_SYMBOLIZER_OPTS\fP is primarily useful for supplementing the command\-line
63 options when \fBllvm\-symbolizer\fP is invoked by another program or
67 All of the following examples use the following two source files as input. They
68 use a mixture of C\-style and C++\-style linkage to illustrate how these names are
69 printed differently (see \fI\%\-\-demangle\fP).
115 $ clang \-g test.cpp \-o test.elf
116 $ clang \-g \-O2 test.cpp \-o inlined.elf
122 Example 1 \- addresses and object on command\-line:
128 $ llvm\-symbolizer \-\-obj=test.elf 0x4004d0 0x400490
139 Example 2 \- addresses on standard input:
149 $ llvm\-symbolizer \-\-obj=test.elf < addr.txt
151 /tmp/test.cpp:15:0
163 Example 3 \- object specified with address:
169 $ llvm\-symbolizer \(dqtest.elf 0x400490\(dq \(dqFILE:inlined.elf 0x400480\(dq
180 $ llvm\-symbolizer < addr2.txt
182 /tmp/test.cpp:15:0
191 Example 4 \- BUILDID and FILE prefixes:
197 $ llvm\-symbolizer \(dqFILE:test.elf 0x400490\(dq \(dqDATA BUILDID:123456789abcdef 0x601028\(dq
208 $ llvm\-symbolizer < addr3.txt
219 Example 5 \- CODE and DATA prefixes:
225 $ llvm\-symbolizer \-\-obj=test.elf \(dqCODE 0x400490\(dq \(dqDATA 0x601028\(dq
236 $ llvm\-symbolizer < addr4.txt
238 /tmp/test.cpp:15:0
247 Example 6 \- path\-style options:
251 shows the default absolute path, the second \-\-basenames, and the third
252 shows \-\-relativenames.
260 $ clang \-g foo/test.cpp \-o test.elf
261 $ llvm\-symbolizer \-\-obj=test.elf 0x4004a0
263 /tmp/foo/test.cpp:15:0
264 $ llvm\-symbolizer \-\-obj=test.elf 0x4004a0 \-\-basenames
266 test.cpp:15:0
267 $ llvm\-symbolizer \-\-obj=test.elf 0x4004a0 \-\-relativenames
269 foo/test.cpp:15:0
277 .B \-\-adjust\-vma <offset>
284 .B \-\-basenames, \-s
290 .B \-\-build\-id
292 string. Mutually exclusive with \fI\%\-\-obj\fP\&.
296 .B \-\-color [=<always|auto|never>]
297 Specify whether to use color in \fI\%\-\-filter\-markup\fP mode. Defaults to
299 \fB\-\-color\fP alone is equivalent to \fB\-\-color=always\fP\&.
303 .B \-\-debug\-file\-directory <path>
304 Provide a path to a directory with a \fI\&.build\-id\fP subdirectory to search for
310 .B \-\-debuginfod, \-\-no\-debuginfod
318 .B \-\-demangle, \-C
320 name \fI_Z3bazv\fP becomes \fIbaz()\fP, whilst the non\-mangled name \fIfoz\fP is printed
325 .B \-\-dwp <path>
331 .B \-\-fallback\-debug\-path <path>
338 .B \-\-filter\-markup
339 Reads from standard input, converts contained
340 \fI\%Symbolizer Markup\fP into human\-readable form,
364 .B \-\-functions [=<none|short|linkage>], \-f
371 .B \-\-help, \-h
376 .B \-\-inlining, \-\-inlines, \-i
382 .B \-\-no\-inlines
387 .B \-\-no\-demangle
392 .B \-\-obj <path>, \-\-exe, \-e
393 Path to object file to be symbolized. If \fB\-\fP is specified, read the object
394 directly from the standard input stream. Mutually exclusive with
395 \fI\%\-\-build\-id\fP\&.
399 .B \-\-output\-style <LLVM|GNU|JSON>
412 Prints an address\(aqs debug\-data discriminator when it is non\-zero. One way to
413 produce discriminators is to compile with clang\(aqs \-fdebug\-info\-for\-profiling.
426 $ llvm\-symbolizer \-\-obj=inlined.elf 0x4004be 0x400486 \-p
428 (inlined by) main at /tmp/test.cpp:15:0
432 $ llvm\-symbolizer \-\-output\-style=LLVM \-\-obj=inlined.elf 0x4004be 0x400486 \-p \-\-no\-inlines
437 $ llvm\-symbolizer \-\-output\-style=GNU \-\-obj=inlined.elf 0x4004be 0x400486 \-p \-\-no\-inlines
441 $ clang \-g \-fdebug\-info\-for\-profiling test.cpp \-o profiling.elf
442 $ llvm\-symbolizer \-\-output\-style=GNU \-\-obj=profiling.elf 0x401167 \-p \-\-no\-inlines
443 main at /tmp/test.cpp:15 (discriminator 2)
445 $ llvm\-symbolizer \-\-output\-style=JSON \-\-obj=inlined.elf 0x4004be 0x400486 \-p
466 \(dqLine\(dq: 15,
497 .B \-\-pretty\-print, \-p
498 Print human readable output. If \fI\%\-\-inlining\fP is specified, the
507 $ llvm\-symbolizer \-\-obj=inlined.elf 0x4004be \-\-inlining \-\-pretty\-print
509 (inlined by) main at /tmp/test.cpp:15:0
517 .B \-\-print\-address, \-\-addresses, \-a
524 $ llvm\-symbolizer \-\-obj=inlined.elf \-\-print\-address 0x4004be
529 /tmp/test.cpp:15:0
531 $ llvm\-symbolizer \-\-obj=inlined.elf 0x4004be \-\-pretty\-print \-\-print\-address
533 (inlined by) main at /tmp/test.cpp:15:0
541 .B \-\-print\-source\-context\-lines <N>
548 $ llvm\-symbolizer \-\-obj=test.elf 0x400490 \-\-print\-source\-context\-lines=3
561 .B \-\-relativenames
563 of the absolute path. If the command\-line to the compiler included
568 .B \-\-verbose
575 $ llvm\-symbolizer \-\-obj=inlined.elf \-\-verbose 0x4004be
588 Line: 15
597 .B \-\-version, \-v
603 Read command\-line options from response file \fI<FILE>\fP\&.
608 .B \-\-dia
610 llvm\-symbolizer will fall back to the native implementation.
612 .SH MACH-O SPECIFIC OPTIONS
615 .B \-\-default\-arch <arch>
617 Mach\-O universal binary), symbolize the object file for a given architecture.
619 the input (see example below). If the architecture is not specified in either
630 $ llvm\-symbolizer < addr.txt
643 .B \-\-dsym\-hint <path/to/file.dSYM>
650 \fBllvm\-symbolizer\fP returns 0. Other exit codes imply an internal program
654 \fBllvm\-addr2line(1)\fP
658 2003-2023, LLVM Project