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.

Note

The PC register is not set with this command.

Show/hideSyntax

file [filename] [offset] [-option]

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

Where:

filename

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

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.

Show/hideExample

Example 34. file, symbol-file

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

Show/hideSee also

Copyright © 2010, 2011 ARM. All rights reserved.ARM DUI 0452H
Non-ConfidentialID111711