llvm.org GIT mirror llvm / release_39 docs / CommandGuide / llvm-symbolizer.rst
release_39

Tree @release_39 (Download .tar.gz)

llvm-symbolizer.rst @release_39view markup · raw · history · blame

llvm-symbolizer - convert addresses into source code locations

SYNOPSIS

:program:`llvm-symbolizer` [options]

DESCRIPTION

:program:`llvm-symbolizer` reads object file names and addresses from standard input and prints corresponding source code locations to standard output. If object file is specified in command line, :program:`llvm-symbolizer` processes only addresses from standard input, the rest is output verbatim. This program uses debug info sections and symbol table in the object files.

EXAMPLE

$ cat addr.txt
a.out 0x4004f4
/tmp/b.out 0x400528
/tmp/c.so 0x710
/tmp/mach_universal_binary:i386 0x1f84
/tmp/mach_universal_binary:x86_64 0x100000f24
$ llvm-symbolizer < addr.txt
main
/tmp/a.cc:4

f(int, int)
/tmp/b.cc:11

h_inlined_into_g
/tmp/header.h:2
g_inlined_into_f
/tmp/header.h:7
f_inlined_into_main
/tmp/source.cc:3
main
/tmp/source.cc:8

_main
/tmp/source_i386.cc:8

_main
/tmp/source_x86_64.cc:8
$ cat addr2.txt
0x4004f4
0x401000
$ llvm-symbolizer -obj=a.out < addr2.txt
main
/tmp/a.cc:4

foo(int)
/tmp/a.cc:12
$cat addr.txt
0x40054d
$llvm-symbolizer -inlining -print-address -pretty-print -obj=addr.exe < addr.txt
0x40054d: inc at /tmp/x.c:3:3
 (inlined by) main at /tmp/x.c:9:0
$llvm-symbolizer -inlining -pretty-print -obj=addr.exe < addr.txt
inc at /tmp/x.c:3:3
 (inlined by) main at /tmp/x.c:9:0

OPTIONS

EXIT STATUS

:program:`llvm-symbolizer` returns 0. Other exit codes imply internal program error.