Launching the debugger from the command-line console

To launch the debugger:

  1. Launch a command-line console:

    On Windows, select Start → All Programs → ARM DS-5 → DS-5 Command Prompt.

    On Linux:

    1. Add the install_directory/bin directory to your PATH environment variable. If it is already configured then you can skip this step.

    2. Open a Unix bash shell.

  2. Launch the debugger using the following command-line syntax:

    debugger --target [--target_device] [option]...


    --target=host:port | filename

    For gdbserver connections you can specify the host:port for the connection between the debugger and gdbserver.

    A serial connection requires an XML file similar to the following example:

    Example 1. mySerialConfig.xml

    <?xml version="1.0"?>
        <rddi type="rddi-debug-gdb"/>

    --target_device=number | name

    Specifies the device number or name. You must launch the debugger with --target_device command-line option when configuring a connection to a target containing multiple devices. If you do not specify --target_device then the debugger lists all the available devices and quits.

    and option can be any of the following:


    Displays a summary of the main command-line options.


    Specifies a script file containing debugger commands to control and debug your target. You can repeat this option if you have several script files. The scripts are run in the order specified.


    Specifies interactive mode that redirects standard input and output to the debugger from the current command-line console, For example, Windows Command Prompt or Unix bash shell. This is the default if no script file is specified.


    Specifies the name of the target Operating System (OS), for example, --target_os=linux. This enables OS support within the debugger for example, shared library support.

    --stop_on_connect=true | false

    Specifies whether the debugger stops the target when it connects to the target device. To leave the target unmodified on connection you must specify false. The default is --stop_on_connect=true.

    --continue_on_error=true | false

    Specifies whether the debugger stops the target and exits the current script when an error occurs. The default is --continue_on_error=false.


    Specifies the image file for the debugger to load when it connects to the target.


    Specifies the type of logging configuration to output runtime messages from the debugger.



    Specifies a predefined logging configuration or a user-defined logging configuration file:


    Output messages using the predefined INFO level configuration. This level does not output debug messages. This is the default.


    Output messages using the predefined DEBUG level configuration. This option outputs both INFO level and DEBUG level messages.


    Specifies a user-defined logging configuration file to customize the output of messages. The debugger supports log4j configuration files.


    Specifies an output file to receive runtime messages from the debugger. If this option is not used then output messages are redirected to the console.


    Specifies the stack base, also known as the top of memory. Top of memory is only used for semihosting operations.


    Enables semihosting operations.


    Disables semihosting operations.


    Disables all semihosting operations to the debugger console.


    Specifies a file to write stderr for semihosting operations.


    Specifies a file to read stdin for semihosting operations.


    Specifies a file to write stdout for semihosting operations.


    Semihosting is used to communicate input/output requests from application code to the host workstation running the debugger.

Show/hideSee also

Copyright © 2010, 2011 ARM. All rights reserved.ARM DUI 0446H