1.3.1 add-symbol-file

Loads additional debug information into the debugger.

Syntax

add-symbol-file filename [offset] [-s section address]...

Where:

filename

Specifies the image, shared library, or Operating System (OS) module.

Note:

Shared library and OS modules depend on connections that support loading these types of files. This option pends the file until the library or OS module is loaded.
offset

Specifies the offset that is added to all addresses within the image. If offset is not specified then the default for:

  • An image is zero.

  • A shared library is the load address of the library. If the application has not currently loaded the specified library then the request is pended until the library is loaded and the offset can be determined.

s

For relocatable objects, this specifies the address to which a section was relocated.

section

Specifies the name of the relocated section.

address

Specifies the address of the section. This can be either an address or an expression that evaluates to an address. You can also specify the address space.

You can use the info files command to display information about the loaded files.

Example 1-4 Examples

add-symbol-file myFile.axf                    # Load symbols at entry point+0x0000
add-symbol-file myLib.so                      # Pends symbol file for shared library
add-symbol-file myModule.ko                   # Pends symbol file for OS module
add-symbol-file myFile.axf 0x2000             # Load symbols at entry point+0x2000
add-symbol-file relocate.o -s .text 0x1000 -s .data 0x2000
                                              # Load symbols from relocate.o with
                                              # section .text relocated to 0x1000 and
                                              # section .data relocated to 0x2000
add-symbol-file vmlinux N:0                   # Load symbols at the non-secure address 0x00
add-symbol-file vmlinux EL2:0x4080000000      # Load symbols for the non-secure address space EL2:0x4080000000
Non-ConfidentialPDF file icon PDF versionARM DUI0452Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.