OS Manuals

/usr/bin/llvm-addr2line

Low-level virtual machine 23 - core frameworks

From llvm-23 23.1.5-r0 (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
  --default-arch=<value> Default architecture for multi-arch containers (e.g. Mach-O objects or AIX archives)
  -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
  --pdb=<file>           Path to PDB file
  --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 GSYM Related Options:
  --disable-gsym Don't consider using GSYM files for symbolication
  --gsym-file-directory=<dir>
                 Path to directory where to look for GSYM files

llvm-symbolizer Mach-O Specific Options:
  --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 (43)
OptionDescriptionSource
--addressesShow address before line informationhelp
--adjust-vma offsetAdd specified offset to object file addresseshelp
-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
--pdb filePath to PDB filehelp
--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
--gsym-file-directory dirPath to directory where to look for GSYM 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.