| Copyright © 2003, 2004 ARM Limited. All rights reserved. | ARM DUI 0234B |
| Non-Confidential | |
 PDF version | |
| Home > Starting to use RealView Debugger > Starting RealView Debugger > Starting from the command line |
| |||
| Home > Starting to use RealView Debugger > Starting RealView Debugger > 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:
-batRuns 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.
Do not use -b without -inc.
If you use only -inc, the script
file is run with the GUI enabled.
-cmdRuns 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.
-installSpecifies 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.
-userSpecifies 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.
-homeSpecifies 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.
-awsRuns 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.
-execSpecifies the image loaded when RealView Debugger runs. The image specification can also include target details and image arguments.
-incRuns 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.
-jouRuns a RealView Debugger session with the specified journal
file open for writing. Can be replaced with -j.
-logRuns a RealView Debugger session with the specified log
file open for writing. Can be replaced with -l.
-sRuns a RealView Debugger session with the specified STDIOlog file open for writing.
-nologoRuns a RealView Debugger session without displaying a Windows splash screen.
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_directoryC:\Program Files\ARM\RVD\Core\1.6.1\.build_num\win_32-pentium
To find more information on operations available from the command line, see:
Chapter 3 Working with Images for details on loading images.
Chapter 4 Controlling Execution for details on using log and journal files.
Chapter 11 Configuring Workspace Settings for details on workspaces.
| Copyright © 2003, 2004 ARM Limited. All rights reserved. | ARM DUI 0234B |
| Non-Confidential | |
| PDF version | |
| Home > Starting to use RealView Debugger > Starting RealView Debugger > Starting from the command line |