RealView® Debugger Command Line Reference Guide 2.3.7. ARGUMENTS

2.3.7. ARGUMENTS

The ARGUMENTS command enables you to specify the command-line arguments for the application. These are used for each subsequent run on this connection.

Syntax

ARGUMENTS [{,delete | ,prompt}]

ARGUMENTS [,default] string

where:

delete: Delete the currently set ARGUMENTS list, so the argv list for the next run of a program is only the program filename.
default: Make the defined arguments the default, so they apply to new connections created in this session.
prompt: Display a dialog to prompt you for the arguments when the ARGUMENTS command is executed.
string: Defines the command line that the application sees when it inspects the argv[] array, or equivalent.

Description

The ARGUMENTS command enables you to specify arguments that the target application might require when it starts execution. The specified string is made available to ARM applications through the semihosting mechanism. Any previous argument definition is overwritten.

If a literal double-quote character is required in the arguments, you must escape it using the backslash character and embed it in single quotes, for example:

ARGUMENTS "-f ’\"my file.c\"’

If you enter this command without any parameters, the current argument definition is displayed.

Note

You can also specify arguments as part of the LOAD command.

If you unload an image that requires arguments, any arguments defined with this command are not used by the image when you next reload it. After reloading the image, enter this command again to specify the arguments before running the image.

Examples

The following examples show how to use ARGUMENTS:

ARGUMENTS "-f file.c -o file.o"

Sets the command line so that, if the line is parsed in the normal way by _main(), the argv[] array contains:

argv[0]: target program filename, for example: com.axf
argv[1]: -f
argv[2]: file.c
argv[3]: -o
argv[4]: file.o
argv[5]: NULL

ARGUMENTS "-f ’\"my file.c\"’ -o ’\"my file.o\"’"

Sets the command line so that, if the line is parsed in the normal way by _main(), the argv[] array contains:

argv[0]: target program filename, for example: "com.axf"
argv[1]: -f
argv[2]: "my file.c"
argv[3]: -o
argv[4]: "my file.o"
argv[5]: NULL

load /pd/r ’com.axf;;-f file.c -o file.o’ go arguments "-f '\"my file.c\"' -o '\"my file.o\"'" restart go

Changes the arguments without unloading the image. Table 2.15 shows the argument assignments in the original LOAD command, and the new assignments specified by the ARGUMENTS command.

Table 2.15. Changed argument assignments

Argument	Original value	New value
`argv[0]`	`com.axf`	`com.axf`
`argv[1]`	`-f`	`-f`
`argv[2]`	`file.c`	`"my file.c"`
`argv[3]`	`-o`	`-o`
`argv[4]`	`file.o`	`"my file.o"`
`argv[5]`	`NULL`	`NULL`

Copyright © 2002-2005 ARM Limited. All rights reserved.	ARM DUI 0175G
Non-Confidential
PDF version

2.3.7. ARGUMENTS

Syntax

Description

Note

Examples

See also