You copied the Doc URL to your clipboard.

file, symbol-file

This command loads debug information from an image into the debugger and records the entry point address for future use by the run and start commands. Subsequent use of the file command discards existing information before loading the new debug information. If you want to append debug information instead of replacing it, you can use the add-symbol-file command.


The PC register is not set with this command.


file [filename] [offset] [-option]

symbol-file [filename] [offset] [-option]



Specifies the image. If no filename is specified then the current debug information is discarded.


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.


Controls how debug information is loaded:


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


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.


file "myFile.axf"                      # Load debug information on demand
file "images\myFile.axf"               # Load debug information on demand
file                                   # Discard all current debug information
file "myFile.axf" -readnow             # Load all debug information