1.1.2. Starting from the command line

The syntax for the command-line method of starting RealView Debugger is as follows:

rvdebug.exe [-bat|-cmd][-install=pathname][-user=name][-home=pathname] [-aws=pathname|-aws=-][-exec image_pathname] [-inc pathname][-jou pathname][-log pathname][-s pathname][-nologo]

where:

-bat

Runs a RealView Debugger session in batch mode, that is without any user interaction.

Use this with -inc to run a script file containing commands.

Can be replaced with -b.

Note

Do not use -b without -inc. If you use only -inc, the script file is run with the GUI enabled.

-cmd

Runs the command-line debugger only to use CLI commands to carry out debugging tasks. This enables you to interact with RealView Debugger without using the RealView Debugger GUI.

-install

Specifies the installation directory where this differs from the default installation. This is then used to define the location of the default RealView Debugger home directory when RealView Debugger runs for the first time.

This must be used if the environment variable RVDEBUG_INSTALL is not set.

-user

Specifies the user ID in the RealView Debugger home directory used for the debugging session. Where this is not specified, the default Windows login is used. See Defining the home directory for details.

-home

Specifies a RealView Debugger home directory used for the debugging session. If the specified directory does not exist, a new one is created. Where this is not specified, the default directory is used. See Defining the home directory for details.

-aws

Runs a RealView Debugger session with the specified workspace. This overrides any workspace specification that was stored when the previous session ended.

Use -aws=- to start without a workspace.

-exec

Specifies the image loaded when RealView Debugger runs. The image specification can also include target details and image arguments.

-inc

Runs a RealView Debugger session with the specified include file.

Use -inc:

  • in batch mode in association with the -bat setting, to execute the commands contained in the file and then exit RealView Debugger

  • in command-line mode in association with the -cmd setting, to execute the commands contained in the file and then leave RealView Debugger running ready to continue the debugging session

  • in GUI mode on its own, to execute the commands contained in the file during a debugging session.

-jou

Runs a RealView Debugger session with the specified journal file open for writing. Can be replaced with -j.

-log

Runs a RealView Debugger session with the specified log file open for writing. Can be replaced with -l.

-s

Runs a RealView Debugger session with the specified STDIOlog file open for writing.

-nologo

Runs a RealView Debugger session without displaying a Windows splash screen.

Examples

To start RealView Debugger and specify an installation directory, where RVDEBUG_INSTALL is not set:

program_directory\bin\rvdebug.exe -install="C:\Program Files\ARM\RVD”

If RVDEBUG_INSTALL is set then the -install overrides it.

To start RealView Debugger and specify a home directory, where RVDEBUG_HOME is not set:

program_directory\bin\rvdebug.exe -home="program_directory\home\user_home

To start RealView Debugger and specify a workspace:

program_directory\bin\rvdebug.exe" -aws="program_directory\home\user_home\friday_test.aws”

To start RealView Debugger without loading a workspace:

program_directory\bin\rvdebug.exe -aws=-

To start RealView Debugger with a log file open for writing:

program_directory\bin\rvdebug.exe -log "program_directory\home\user_home\test_files\my_log.log”

To start RealView Debugger with a specified image loaded that takes two arguments:

program_directory\bin\rvdebug.exe -exec “C:\myprojects\images\my_image.axf;;arg1 arg2”

In these examples, your program_directory might be a default location such as C:\Program Files\ARM\RVD\Core\1.6.1\build_num\win_32-pentium.

Getting more information

To find more information on operations available from the command line, see:

Copyright © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0234B
Non-Confidential