RealView® Developer Kit Command Line Reference GuideVersion 2.2
Home > RealView Debugger Commands > Alphabetical command reference > UNLOAD

2.3.137. UNLOAD

The UNLOAD command unloads a specified file.

Syntax

UNLOAD [,qualifier] [{filename | file_num}] [=task]

where:

qualifier

If specified, qualifier must be one of the following:

all

Unloads all the files in the file list.

symbols_only

Unloads the symbols only, not the executable image.

image_only

Unloads the executable image only, not the symbols.

filename | file_num

Specifies a file to be unloaded.

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

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

  • the filename and path.

task

Applicable only to RTOS, this specifies a task to be unloaded. Use this form of the command if you are running multiple tasks and want to unload only one of them.

Description

The UNLOAD command unloads a specified file. If you do not specify a file then all files are unloaded. If you specify a file, using either a filename or a file number, then only that file is unloaded. Any unloaded files remain in the file list and can be reloaded.

The effect of unloading the system file is defined by the vehicle. You can unload only symbols or only the image.

Note

If you have specified any arguments for the image, these are lost when you unload the image. If you specified the arguments as part of the LOAD command, you must specify the arguments again when you load the image. Alternatively, after loading the image again, use the ARGUMENTS command to specify the arguments.

You do not have to unload an image to run it again. Use the RESTART command to reset the PC to the entry point, the use the GO command to run the image.

Examples

The following examples show how to use UNLOAD:

unload dhrystone.axf

Unload the symbols (and macros, if any) for the dhrystone program from debugger.

See also

The following commands provide similar or related functionality:

Copyright © 2005, 2006 ARM Limited. All rights reserved.ARM DUI 0284C
Non-Confidential
PDF file icon  PDF version
Home > RealView Debugger Commands > Alphabetical command reference > UNLOAD