RealView® Development Suite AXD and armsd Debuggers Guide 7.2.1. Command-line options

7.2.1. Command-line options

armsd [-help] [-vsn] [[-little] | [-big]] [-cpu name] [ -fpe | [-nofpe]] [-symbols] [-o name] [-script name] [-exec] [-i name] [-clock n] [-target dllname] [[-remote] | [-armul] | [-adp options]] image_name args

where:

-help

Gives a summary of the armsd command-line options.

-vsn

Displays information on the armsd version.

-little

Specifies that memory is to be little-endian (the default setting).

-big

Specifies that memory is to be big-endian.

-cpu name

Specifies the CPU type that is to be simulated. With this option you must not specify -rem or -adp as the target. Specify -armul as the target to invoke RealView ARMulator ISS. If you do not specify a target, RealView ARMulator ISS is invoked if it can simulate the specified processor. If the specified processor cannot be simulated, armsd exits. Instead of name you can specify list, to display a list of processors available on the target. For example:

armsd -cpu list: lists available processors of standard targets (RealView ARMulator ISS and Remote_A)
armsd -armul -cpu list: lists available processors of RealView ARMulator ISS
armsd -target dllname -cpu list: lists available processors of the specified target.

RealView ARMulator ISS is the only ARM supplied target that has a list of available processors.

Instead of -cpu you can still use -proc, but this is now obsolete.

-fpe

Instructs RealView ARMulator ISS to load the FPE on startup.

-nofpe

Instructs RealView ARMulator ISS not to load the FPE on startup (this is the default setting).

-symbols

Reads debug information from the specified image file but does not download the image.

-o name

Writes output from the debuggee to the named file.

-script name

Takes commands from the named file (reverts to stdin on reaching EOF).

-exec

Instructs the debugger to load and execute the named file immediately, and quit when execution stops.

-i name

Adds name to the set of paths to be searched to find source files.

-clock n

Specifies the clock speed in Hz (suffixed with K or M) for RealView ARMulator ISS. This is intended for use with an armsd.map file.

-target dllname

Specifies a .dll file that is a third-party RDI target simulator to be used instead of RealView ARMulator ISS.

-remote

Selects remote debugging. By default this is ADP.

-armul

Selects RealView ARMulator ISS. This is assumed by default if you do not specify a target but do specify a processor type that RealView ARMulator ISS can simulate.

-adp options

Selects remote debugging using ADP, further defined by one or more of the following options:

-port expr

specifies the ADP port to use, where expr selects serial, serial-and-parallel, or ethernet communications and can be one of:

s=n: Selects serial port communications. n can be 1, 2 or a device name.
s=n,p=m: Selects serial-and-parallel port communication. n and m can be 1, 2, or a device name. There must be no space between the arguments.
e=id: Selects ethernet communication. id is the ethernet address of the target board.

For serial and serial-and-parallel communications, you can add ,h=0 to the port expression to switch off the heartbeat feature of ADP. For example, -port s=1,h=0 selects serial port 1 and turns off the ADP heartbeat.

-linespeed n

Sets the line speed to n.

-loadconfig name

Specifies a file containing required configuration data, when using a Remote_A connection to EmbeddedICE. See loadconfig for more information.

-selectconfig name version

Specifies the target for which configuration data is required, when using a Remote_A connection to EmbeddedICE. See selectconfig for more information.

image_name

Gives the name of the file to debug. You can also specify this information using the load command. See load for more information.

args

Gives program arguments. You can also specify this information using the load command. See load for more information.

Note

Where given, the debug file, and any associated arguments, must be the last entry on the command line. This ensures that all specified command-line options are correctly interpreted.

Copyright © 1999-2006 ARM Limited. All rights reserved.	ARM DUI 0066G
Non-Confidential
PDF version