2.2.2. AXD arguments

The syntax for the command-line method of starting AXD is as follows (any arguments must be in lowercase):

axd [-logo|-nologo] [-session session_file_name] [-debug|-exec|-script script_name] [-halt|-nohalt|-attach] [-restore_default] [-clear_registry] [-help] [image_name [parm1 [parm2 [...]]]]

where:

-logo

Displays the splash screen and is the default setting.

-nologo

Suppresses the display of the splash screen.

-session session_file_name

Specifies a file in which an earlier debug session was saved. You must give the full pathname to the required file and, if the filename includes spaces, you must enclose it in quotes. The earlier session is restored to the state it was in when it was saved. Any images in the session file are loaded, and connection to the target is established.

-debug

Loads the image and sets a breakpoint on main(). It does not take an argument. Use this after one or more of the following:

  • default session loaded

  • session explicitly loaded from command line using -session

  • image explicitly loaded from command line.

-exec

Starts execution of the loaded image with the entry point. It does not take an argument. Use this after one or more of the following:

  • default session loaded

  • session explicitly loaded from command line using -session

  • image explicitly loaded from command line.

-script script_name

Obeys the commands in file script_name. This is the equivalent of typing obey script_name in the CLI system view as soon as the debugger starts up. Use this after one or more of the following:

  • default session loaded

  • session explicitly loaded from command line using -session

  • image explicitly loaded from command line.

-halt

Connects AXD to the target and stops execution of the target.

-nohalt

Connects AXD to the target without stopping execution of the target. This is possible only with targets that support RealMonitor. If connection of AXD might stop execution of the target, then the attempt to connect is abandoned.

-attach

Connects AXD to the target. Execution of the target is not stopped if the target supports RealMonitor. Execution of other targets stops when the connection is made.

-restore_default

Starts AXD without reference to the default session file. AXD starts with default windows displayed in a default layout.

-clear_registry

Starts AXD without reference to the default session file. AXD starts with default windows displayed in a default layout. In addition, all existing target configuration information is deleted. The registry is cleared, but any automatically-detectable targets are re-detected and reappear in the registry.

-help

Displays text describing how to use the AXD command.

image_name

Specifies a file containing an image to be loaded. You must place this name, followed by any required parameters, at the end of the command, because the remainder of the command passes to the image, not to AXD.

parm1, parm2, ...

Any parameters required by image_name.

Examples

To restore a debug session saved in file friday.ses, type:

axd -session friday.ses

To launch AXD and load img01.axf with arguments 10, 3.14159, and ABC, type:

axd img01.axf 10 3.14159 ‘ABC’
Copyright © 1999-2006 ARM Limited. All rights reserved.ARM DUI 0066G
Non-Confidential