You copied the Doc URL to your clipboard.


Loads additional debug information into the debugger.


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



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.

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.


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


Specifies the name of the relocated section.


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                      # 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