---
name: "llvm-symbolizer-4.0"
section: "1"
platform: "linux"
package: "llvm-4.0"
version: "1:4.0.1-10~deb9u2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/llvm-symbolizer-4.0"
---

# llvm-symbolizer-4.0(1)

convert addresses into source code locations

## NAME

llvm-symbolizer - convert addresses into source code locations

## SYNOPSIS

**llvm-symbolizer** \[options\]

## DESCRIPTION

**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, **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

- **-obj**

  Path to object file to be symbolized.

- **-functions=\[none\|short\|linkage\]**

  Specify the way function names are printed (omit function name, print short function name, or print full linkage name, respectively). Defaults to **linkage**.

- **-use-symbol-table**

  Prefer function names stored in symbol table to function names in debug info sections. Defaults to true.

- **-demangle**

  Print demangled function names. Defaults to true.

- **-inlining**

  If a source code location is in an inlined function, prints all the inlnied frames. Defaults to true.

- **-default-arch**

  If a binary contains object files for multiple architectures (e.g. it is a Mach-O universal binary), symbolize the object file for a given architecture. You can also specify architecture by writing **binary\_name:arch\_name** in the input (see example above). If architecture is not specified in either way, address will not be symbolized. Defaults to empty string.

- **-dsym-hint=\<path/to/file.dSYM\>**

  (Darwin-only flag). If the debug info for a binary isn't present in the default location, look for the debug info at the .dSYM path provided via the **-dsym-hint** flag. This flag can be used multiple times.

- **-print-address**

  Print address before the source code location. Defaults to false.

- **-pretty-print**

  Print human readable output. If **-inlining** is specified, enclosing scope is prefixed by (inlined by). Refer to listed examples.

## EXIT STATUS

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

## AUTHOR

Maintained by The LLVM Team (http://llvm.org/).

## COPYRIGHT

2003-2018, LLVM Project