mirror of
https://github.com/c64scene-ar/llvm-6502.git
synced 2025-11-04 05:17:07 +00:00
bf6e3f9257
Change --functions option in llvm-symbolizer tool to accept values "none", "short" or "linkage". Update the tests and docs accordingly. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@209050 91177308-0d34-0410-b5e6-96231b3b80d8
99 lines
2.3 KiB
ReStructuredText
99 lines
2.3 KiB
ReStructuredText
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` reads
|
|
only addresses from standard input. 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
|
|
/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
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
.. option:: -obj
|
|
|
|
Path to object file to be symbolized.
|
|
|
|
.. option:: -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``.
|
|
|
|
.. 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.
|
|
|
|
.. option:: -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.
|
|
|
|
EXIT STATUS
|
|
-----------
|
|
|
|
:program:`llvm-symbolizer` returns 0. Other exit codes imply internal program error.
|