OS Manuals

/usr/bin/addr2line

GNU binutils

From binutils 2.47-r4 (os), captured 2026-11-10 by running addr2line --help (exit 0). permalink

Usage: /usr/bin/addr2line [option(s)] [addr(s)]
 Convert addresses into line number/file name pairs.
 If no addresses are specified on the command line, they will be read from stdin
 The options are:
  @<file>                Read options from <file>
  -a --addresses         Show addresses
  -b --target=<bfdname>  Set the binary file format
  -e --exe=<executable>  Set the input file name (default is a.out)
  -i --inlines           Unwind inlined functions
  -j --section=<name>    Read section-relative offsets instead of addresses
  -p --pretty-print      Make the output easier to read for humans
  -s --basenames         Strip directory names
  -f --functions         Show function names
  -C --demangle[=style]  Demangle function names
  -R --recurse-limit     Enable a limit on recursion whilst demangling.  [Default]
  -r --no-recurse-limit  Disable a limit on recursion whilst demangling
  -h --help              Display this information
  -v --version           Display the program's version

/usr/bin/addr2line: supported targets: elf64-x86-64 elf32-i386 elf32-x86-64 pei-i386 pe-x86-64 pei-x86-64 elf64-little elf64-big elf32-little elf32-big srec symbolsrec verilog tekhex binary ihex plugin
Report bugs to <https://sourceware.org/bugzilla/>
Options (25)
OptionDescriptionSource
-a --addressesShow addresseshelp + man
-b --target=<bfdnameSet the binary file formathelp + man
-e --exe=<executableSet the input file name (default is a.out)help + man
-i --inlinesUnwind inlined functionshelp + man
-j --section=<nameRead section-relative offsets instead of addresseshelp + man
-p --pretty-printMake the output easier to read for humanshelp + man
-s --basenamesStrip directory nameshelp + man
-f --functionsShow function nameshelp + man
-C --demangle[=style[--demangle[=style]](#demangle_=)help + man
-R --recurse-limitEnable a limit on recursion whilst demangling.help + man
-r --no-recurse-limitDisable a limit on recursion whilst demanglinghelp + man
-h --helpDisplay this informationhelp
-v --versionDisplay the program's versionhelp
--addressesDisplay the address before the function name, file and line number information. (in the manual page but not in --help)man
--target bfdnameSpecify that the object-code format for the object files is bfdname. (in the manual page but not in --help)man
--exe filenameSpecify the name of the executable for which addresses should be translated. (in the manual page but not in --help)man
--functionsDisplay function names as well as file and line number information. (in the manual page but not in --help)man
--basenamesDisplay only the base of each file name. (in the manual page but not in --help)man
--inlinesIf the address belongs to a function that was inlined, the source information for all enclosing scopes back to the first non-inlined function will also be printed. (in the manual page but not in --help)man
--sectionRead offsets relative to the specified section instead of absolute addresses. (in the manual page but not in --help)man
--pretty-printMake the output more human friendly: each location are printed on one line. (in the manual page but not in --help)man
--recurse-limit (in the manual page but not in --help)man
--no-recurse-limit (in the manual page but not in --help)man
--recursion-limit (in the manual page but not in --help)man
--no-recursion-limitEnables or disables a limit on the amount of recursion performed whilst demangling strings. (in the manual page but not in --help)man

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