diff options
| author | Alexey Samsonov <samsonov@google.com> | 2013-03-01 07:58:27 +0000 |
|---|---|---|
| committer | Alexey Samsonov <samsonov@google.com> | 2013-03-01 07:58:27 +0000 |
| commit | 14809fd5261356365de670ef7ddf9103bb0ae6ba (patch) | |
| tree | 60f939afc3f1e52ae64e1c9799359faaeeb991f4 /docs/CommandGuide | |
| parent | 72a001d1f8e537624930c437808825a23e8b46bf (diff) | |
| download | llvm-14809fd5261356365de670ef7ddf9103bb0ae6ba.tar.gz llvm-14809fd5261356365de670ef7ddf9103bb0ae6ba.tar.bz2 llvm-14809fd5261356365de670ef7ddf9103bb0ae6ba.tar.xz | |
Docs for llvm-symbolizer command-line tool
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@176337 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs/CommandGuide')
| -rw-r--r-- | docs/CommandGuide/index.rst | 1 | ||||
| -rw-r--r-- | docs/CommandGuide/llvm-symbolizer.rst | 65 |
2 files changed, 66 insertions, 0 deletions
diff --git a/docs/CommandGuide/index.rst b/docs/CommandGuide/index.rst index 9bfa9645d8..ac8a944a2e 100644 --- a/docs/CommandGuide/index.rst +++ b/docs/CommandGuide/index.rst @@ -28,6 +28,7 @@ Basic Commands llvm-diff llvm-cov llvm-stress + llvm-symbolizer Debugging Tools ~~~~~~~~~~~~~~~ diff --git a/docs/CommandGuide/llvm-symbolizer.rst b/docs/CommandGuide/llvm-symbolizer.rst new file mode 100644 index 0000000000..73babb1e5c --- /dev/null +++ b/docs/CommandGuide/llvm-symbolizer.rst @@ -0,0 +1,65 @@ +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. This +program uses debug info sections and symbol table in the object files. + +EXAMPLE +-------- + +.. code-block:: console + + $ cat addr.txt + a.out 0x4004f4 + /tmp/b.out 0x400528 + /tmp/c.so 0x710 + $ 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 + +OPTIONS +------- + +.. option:: -functions + + Print function names as well as source file/line locations. Defaults to true. + +.. option:: -use-symbol-table + + Prefer function names stored in symbol table to function names + in debug info sections. Defaults to true. + +.. option:: -demangle + + Print demangled function names. Defaults to true. + +.. option:: -inlining + + If a source code location is in an inlined function, prints all the + inlnied frames. Defaults to true. + +EXIT STATUS +----------- + +:program:`llvm-symbolizer` returns 0. Other exit codes imply internal program error. |