2.3.3. ADDFILE

The ADDFILE command adds the named file to the executable image file list but does not load it. You can optionally empty the list before adding the new filename.

Syntax

ADDFILE [,auto] =filename [=string,...]

where:

auto

Specifies that only one added file is permitted for each process or processor. Any previously added file is removed when the specified file is added.

filename

The name of the file to be added. You must use double quotes around the filename if it contains any spaces.

You can include one of more environment variables in the filename. For example, if MYPATH defines the location C:\Myimages, you can specify:

adsfile ="$MYPATH\\myimage.axf"
string

The target pathname, for example, an RTOS loader.

Description

The RealView Debugger executable file list contains the names of the files containing the target code for your application. Normally this contains a single linker output file, for example dhry.axf and, in this case, you use the LOAD and RELOAD commands as required.

However, when the application is more complex it is sometimes easier to create it as several files, for example one file for the Operating System (OS) and one for each major process. In these cases, you use the ADDFILE and RELOAD, or the ADDFILE and LOAD/A commands, to manipulate the files that are loaded onto the target.

To load the files on the file list use RELOAD, described on RELOAD.

Examples

The following example removes any existing files from the executable file list and loads dhry.axf into it. The reload command then transfers the executable contents of dhry.axf to the target and sets the processor PC to the image entry point:

addfile,auto =c:\source\debug\dhry.axf
reload

This is the same as:

load c:\source\debug\dhry.axf

This example loads the file dhry.axf into the file list, removing any existing files. It then adds the file kernel.axf to the file list. The reload command transfers the executable contents of both files to the target and sets the PC to the entry address of the last executable loaded, in this case that of kernel.axf.

addfile,auto =c:\source\dhry\debug\dhry.axf
addfile =c:\source\OS\debug\kernel.axf
reload

See also

The following commands provide similar or related functionality:

Copyright © 2005, 2006 ARM Limited. All rights reserved.ARM DUI 0284C
Non-Confidential