llvm/docs/CommandGuide/llvm-addr2line.rst

   1 llvm-addr2line - a drop-in replacement for addr2line
   2 ====================================================
   3
   4 .. program:: llvm-addr2line
   5
   6 SYNOPSIS
   7 --------
   8
   9 :program:`llvm-addr2line` [*options*]
  10
  11 DESCRIPTION
  12 -----------
  13
  14 :program:`llvm-addr2line` is an alias for the :manpage:`llvm-symbolizer(1)`
  15 tool with different defaults. The goal is to make it a drop-in replacement for
  16 GNU's :program:`addr2line`.
  17
  18 Here are some of those differences:
  19
  20 -  ``llvm-addr2line`` interprets all addresses as hexadecimal and ignores an
  21    optional ``0x`` prefix, whereas ``llvm-symbolizer`` attempts to determine
  22    the base from the literal's prefix and defaults to decimal if there is no
  23    prefix.
  24
  25 -  ``llvm-addr2line`` defaults not to print function names. Use `-f`_ to enable
  26    that.
  27
  28 -  ``llvm-addr2line`` defaults not to demangle function names. Use `-C`_ to
  29    switch the demangling on.
  30
  31 -  ``llvm-addr2line`` defaults not to print inlined frames. Use `-i`_ to show
  32    inlined frames for a source code location in an inlined function.
  33
  34 -  ``llvm-addr2line`` uses `--output-style=GNU`_ by default.
  35
  36 -  ``llvm-addr2line`` parses options from the environment variable
  37    ``LLVM_ADDR2LINE_OPTS`` instead of from ``LLVM_SYMBOLIZER_OPTS``.
  38
  39 SEE ALSO
  40 --------
  41
  42 :manpage:`llvm-symbolizer(1)`
  43
  44 .. _-f: llvm-symbolizer.html#llvm-symbolizer-opt-f
  45 .. _-C: llvm-symbolizer.html#llvm-symbolizer-opt-c
  46 .. _-i: llvm-symbolizer.html#llvm-symbolizer-opt-i
  47 .. _--output-style=GNU: llvm-symbolizer.html#llvm-symbolizer-opt-output-style