| |||
Home > DS-5 Debugger commands > DS-5 Debugger commands listed in alphabetical order > add-symbol-file |
This command loads additional debug information into the debugger.
add-symbol-file
filename
[offset
] [-option
] [-s section
address
]...
Where:
filename
Specifies the image, shared library, or Operating System (OS) module.
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
is
not specified then the default for:offset
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 relocation of symbols being loaded from a relocatable object file.
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.
Example 6. 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 relocate # symbols defined in .text or .data sections