# Address converter

The address converter utility translates the specified program addresses to their corresponding source file names and line numbers in an object file.

The addresses must be in hexadecimal format. If no addresses are specified, the utility attempts to read them from the standard input.

By default, the utility uses a.out as the ELF object file. A different object file can be specified in a command argument.

Note

This utility returns zero on success, or greater than zero if an error occurs.

## Command

To start the address converter utility from the command line:

hexagon-addr2line [<option...>] [<address...>]
    Copy to clipboard

Where `<option>` is one or more of the following:

--demangle        | -C
    --exe=<pathname>  | -e <pathname>
    --functions       | -f
    --help            | -H
    --section=<sectionname>
    --target=<target> | -b <target>
    --version         | -V
    Copy to clipboard

## Options

--demangle
    -C
    Copy to clipboard

Demangle C++ names.

--exe=<pathname>
    -e <pathname>
    Copy to clipboard

Use the specified ELF object to translate addresses. The default object file name is `a.out`.

--functions
    -f
    Copy to clipboard

Display function names in addition to the file and line number information.

--help
    -H
    Copy to clipboard

Display command usage information and then exit.

--section=<sectionname>
    Copy to clipboard

Treat address values as offsets into the specified section.

--target=<target>
    -b <target>
    Copy to clipboard

This option is accepted for compatibility with the GNU address converter, but it is ignored.

--version
    -V
    Copy to clipboard

Display the utility version identifier and then exit.

## Output formats

For each address:

- If `-f` is not specified, the utility prints the corresponding file name and line number on a single line.
- If `-f` is specified, the utility prints the function name corresponding to the address on one line, and the associated file name and line number on the following line.

The file name and line number are printed as `<filename>:<linenumber>`.

If a file or function name cannot be determined, the address converter prints a question mark in its place. If a line number cannot be determined, a zero is printed in its place.

## Examples

Map the `080483c4` address in the default executable `a.out` to a source file name and line number:

% addr2line 080483c4
    Copy to clipboard

Map address `080483c4` in an executable `helloworld`:

% addr2line -e helloworld 080483c4
    Copy to clipboard

Use the address converter as a filter, reading addresses from the standard input:

% addr2line
    Copy to clipboard

Print the function name for an address together with its source file and line number:

% addr2line -f 080483c4
    Copy to clipboard

Last Published: Oct 06, 2026

[Previous Topic
Options](https://docs.qualcomm.com/bundle/publicresource/80-N3040-23/topics/cpp-filter.md) [Next Topic
DWARF interpreter](https://docs.qualcomm.com/bundle/publicresource/80-N3040-23/topics/dwarf-interpreter.md)