2.3.109. RELOAD

Loads a linked program image containing program code and data.

Syntax

RELOAD [{,qualifier...}] [{filename | file_num}] [=task]

where:

qualifier

If specified, qualifier must be one of the following:

all

Loads all the files in the file list.

symbols_only

Reloads the symbols only, not the executable image.

image_only

Reloads the executable image only, not the symbols.

force

Forces the load to proceed even if it might be aborted because, for example, the file being loaded overlaps a file already loaded.

filename | file_num

Specifies a file to be reloaded. If you do not specify a file, the whole process is reloaded.

Use the DTFILE command to list details of the file or files that are associated with the current connection. The details include:

  • the file number, which is shown at the start of the output for each file listed by the text File file_num

  • the filename and path.

task

Specifies the task that is to start. This parameter is required only when the target is running multiple tasks.

Description

The RELOAD command loads or reloads an absolute file image containing program code and data. You can load a specified file, or one or more files from the file list. The PC is reset to the start location.

If any file being reloaded is already loaded, it is unloaded before being loaded again. If the symbols for a given file are already loaded, they are not reloaded unless the file modification date has changed.

You can reload symbols only, or the image only. For details see the descriptions of the command qualifiers.

The effect of reloading the system file is defined by the Debug Interface.

Note

If you reload an image that requires arguments, you must use the ARGUMENTS command to specify them before running the image. Alternatively, use the LOAD command and specify the arguments as part of that command.

See also

Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111