OS Manuals

/usr/bin/llvm-addr2line

Low-level virtual machine 20 - core frameworks

From llvm-20 20.1.8-r21 (os), captured 2026-11-05 by running llvm-addr2line --help (exit 0). permalink

OVERVIEW: llvm-addr2line

USAGE: llvm-addr2line [options] addresses...

OPTIONS:
  --addresses           Show address before line information
  --adjust-vma=<offset> Add specified offset to object file addresses
  -a                    Alias for --addresses
  --basenames           Strip directory names from paths
  --build-id=<value>    Build ID used to look up the object file
  --cache-size=<value>  Max size in bytes of the in-memory binary cache.
  --color=<value>       Whether to use color when symbolizing log markup: always, auto, never
  --color               Use color when symbolizing log markup.
  -C                    Alias for --demangle
  --debug-file-directory=<dir>
                        Path to directory where to look for debug files
  --debuginfod          Use debuginfod to find debug binaries
  -demangle=false       Alias for --no-demangle
  -demangle=true        Alias for --demangle
  --demangle            Demangle function names
  --dia                 Use the DIA library to access symbols (Windows only)
  --dwp=<file>          Path to DWP file to be use for any split CUs
  -e=<file>             Alias for --obj
  --exe=<file>          Alias for --obj
  --exe <file>          Alias for --obj
  -e <file>             Alias for --obj
  -f=<value>            Alias for --functions=
  --fallback-debug-path=<dir>
                        Fallback path for debug binaries
  --filter-markup       Filter symbolizer markup from stdin.
  --functions=<value>   Print function name for a given address
  --functions           Print function name for a given address
  -f                    Alias for --functions
  --help                Display this help
  --inlines             Print all inlined frames for a given address
  --inlining=false      Alias for --no-inlines
  --inlining=true       Alias for --inlines
  --inlining            Alias for --inlines
  -i                    Alias for --inlines
  --no-debuginfod       Don't use debuginfod to find debug binaries
  --no-demangle         Don't demangle function names
  --no-inlines          Do not print inlined frames
  --no-untag-addresses  Remove memory tags from addresses before symbolization
  --obj=<file>          Path to object file to be symbolized (if not provided, object file should be specified for each input line)
  --output-style=style  Specify print style. Supported styles: LLVM, GNU, JSON
  --pretty-print        Make the output more human friendly
  --print-address       Alias for --addresses
  --print-source-context-lines=<value>
                        Print N lines of source file context
  -p                    Alias for --pretty-print
  --relative-address    Interpret addresses as addresses relative to the image base
  --relativenames       Strip the compilation directory from paths
  --skip-line-zero      If an address does not have an associated line number, use the last line number from the current sequence in the line-table
  -s                    Alias for --basenames
  --verbose             Print verbose line info
  --version             Display the version
  -v                    Alias for --version

llvm-symbolizer Mach-O Specific Options:
  --default-arch=<value> Default architecture (for multi-arch objects)
  --dsym-hint=<dir>      Path to .dSYM bundles to search for debug info for the object files

Pass @FILE as argument to read options from FILE.
Options (41)
OptionDescriptionSource
--addressesShow address before line informationhelp
-aAlias for --addresseshelp
--basenamesStrip directory names from pathshelp
--build-id valueBuild ID used to look up the object filehelp
--cache-size valueMax size in bytes of the in-memory binary cache.help
--color valueWhether to use color when symbolizing log markup: always, auto, neverhelp
-CAlias for --demanglehelp
--debug-file-directory dirPath to directory where to look for debug fileshelp
--debuginfodUse debuginfod to find debug binarieshelp
-demangle falseAlias for --no-demanglehelp
--demangleDemangle function nameshelp
--diaUse the DIA library to access symbols (Windows only)help
--dwp filePath to DWP file to be use for any split CUshelp
-e fileAlias for --objhelp
--exe fileAlias for --objhelp
-f valueAlias for --functions=help
--fallback-debug-path dirFallback path for debug binarieshelp
--filter-markupFilter symbolizer markup from stdin.help
--functions valuePrint function name for a given addresshelp
--helpDisplay this helphelp
--inlinesPrint all inlined frames for a given addresshelp
--inlining falseAlias for --no-inlineshelp
-iAlias for --inlineshelp
--no-debuginfodDon't use debuginfod to find debug binarieshelp
--no-demangleDon't demangle function nameshelp
--no-inlinesDo not print inlined frameshelp
--no-untag-addressesRemove memory tags from addresses before symbolizationhelp
--obj filePath to object file to be symbolized (if not provided, object file should be specified for each input line)help
--output-style styleSpecify print style.help
--pretty-printMake the output more human friendlyhelp
--print-addressAlias for --addresseshelp
--print-source-context-lines valuePrint N lines of source file contexthelp
-pAlias for --pretty-printhelp
--relative-addressInterpret addresses as addresses relative to the image basehelp
--relativenamesStrip the compilation directory from pathshelp
--skip-line-zeroIf an address does not have an associated line number, use the last line number from the current sequence in the line-tablehelp
-sAlias for --basenameshelp
--verbosePrint verbose line infohelp
--versionDisplay the versionhelp
-vAlias for --versionhelp
--dsym-hint dirPath to .dSYM bundles to search for debug info for the object fileshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.