add-symbol-file

This command loads additional debug information into the debugger.

Show/hideSyntax

add-symbol-file filename [offset] [-option] [-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.

option

Controls how debug information is loaded:

readnow

Specifies loading all debug information immediately. This option uses more memory and is slower to load but it enables faster debugging.

demandload

Specifies loading debug information when required by the debugger. This option enables a faster load and uses less memory but debugging might be slower. This is the default.

s

Specifies the loading symbols from relocatable object files.

section

Specifies the name of a section in a relocatable file.

address

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

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

Show/hideExample

Example 5. add-symbol-file

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 and resolve
                                      # references to .text or .data sections

Show/hideSee also

Copyright © 2010, 2011 ARM. All rights reserved.ARM DUI 0452D
Non-ConfidentialID011411