# DWARF interpreter

The DWARF interpreter is similar to the address converter. Like the address converter, it translates the specified program addresses to their corresponding source file names and line numbers in an object file. But it also does the following:

- Covers data structures and provides memory layout information
- Does the processing in batch mode, thus allowing for much faster translation of a large set of addresses—the address converter (`addr2line`) translates one address at a time.

The DWARF interpreter (`addr2src`) has a limited ability to correct faulty DWARF information. The intended use of this utility is to script the processing of large traces of addresses, where it can handle mixed text and data.

## Command

To start the DWARF interpreter utility from the command line:

hexagon-addr2src file [<option...>]
    Copy to clipboard

Where [&lt;option…&gt;] is one or more of the following:

--batch-file=<filename>
    --debug
    --get-padding
    --help  |  -h
    --lookup=<address>
    --size=<uint>
    --version
    Copy to clipboard

## Options

-- batch-file=<filename>
    Copy to clipboard

List of addresses in hexadecimal format with a 0x prefix; one address per line with no separators.

--debug
    Copy to clipboard

Verbalize the translation mechanism. This option is intended only for debugging of the utility.

--get-padding
    Copy to clipboard

Find the padding present in the data structures of the ELF.

--help
    -h
    Copy to clipboard

Display command usage information and then exit.

--lookup=<address>
    Copy to clipboard

Look up a variable `<address>` in the debug information or symbol table, and output the name and members at that location.

--size=<uint>
    Copy to clipboard

Range of addresses to look up, starting at `--lookup` (the default value is 1).

--version
    Copy to clipboard

Display the utility version identifier and then exit.

## Output formats

The address, mangled symbol name, source file name and line number, column, discriminator, and inline stack location are printed as:

<address>,<symbolname>,<filename:linenumber>,<column>,<discriminator>,<inline_stack_location>
    Copy to clipboard

If DWARF information is not found for a specified address, only the `<address>` itself is printed.

## Examples

Translate the list of addresses in the `batch.txt` file from an executable `helloworld`:

% addr2src helloworld --batch-file batch.txt
    Copy to clipboard

Translate `1024` consecutive addresses starting at address `0x1000` from an executable `helloworld`:

% addr2src helloworld -lookup=0x00001000 -size=1024
    Copy to clipboard

Get padding information for `1024` consecutive addresses starting at address `0x1000` from an executable `helloworld`:

% addr2src helloworld -lookup=0x00001000 -size=1024 --get-padding
    Copy to clipboard

Last Published: Oct 06, 2026

[Previous Topic
Examples](https://docs.qualcomm.com/bundle/publicresource/80-N3040-23/topics/address-converter.md) [Next Topic
ELF file viewer](https://docs.qualcomm.com/bundle/publicresource/80-N3040-23/topics/elf-file-viewer.md)