2.8.3 Starting the application rewind server and debugging the target-resident application

Use the Start undodb-server and debug target-resident application option to start the application rewind server on the target system and debug an existing application.


Before connecting, you must:

  • Set up the target with an Operating System (OS) installed and booted. See the documentation supplied with the target for more information.
  • Obtain the IP address or name of the target.
  • Set up a Remote Systems Explorer (RSE) connection to the target.
  • Ensure that the application rewind server is available on your target and is added to your PATH environment variable.
  • Ensure that the application you want to debug is available on the target.


  1. From the main menu, select Window > Open Perspective > Other > DS-5 Debug to switch to the DS-5 debug perspective.
  2. From the Run menu, select Debug Configurations....
  3. Select DS-5 Debugger from the configuration tree and then click New launch configuration to create a new configuration.
  4. In the Name field, enter a suitable name for the new configuration.
  5. Select the Connection tab to configure the target connection:
    1. In the Select target panel, select Linux Application Debug > Application Debug with Rewind Support > Connections via undodb-server > Start undodb-server and debug target-resident application.
    2. Select your RSE connection from the list.
    3. Accept the default values for the UndoDB-server (TCP) Port.
  6. Select the Files tab to define the location of the Application on target, Target working directory, and additional Files.
    1. In the Target Configuration panel, enter the location of the Application on target and the Target working directory.
    2. In the Files panel, enter or select the location of the files on the target that you want the debugger to use to load additional debug information. If required, you can also specify other files on the host that you want to download to the target.


      Options in the Files tab are dependent on the type of debug operation that you select.
  7. Select the Debugger tab to configure the debugger settings.
    1. In the Run control panel, specify the actions that you want the debugger to perform after connecting to the target.
    2. In the Host working directory panel, configure the host working directory or use the default.
    3. In the Paths panel, specify any source or library search directories on the host that the debugger uses when it displays source code.
  8. If required, use the Arguments tab to enter arguments that are passed to the application when the debug session starts.
  9. If required, use the Environment tab to create and configure the target environment variables that are passed to the application when the debug session starts.
  10. Click Apply to save the configuration settings.
  11. Click Debug to connect to the target.

When connected, you are presented with all the relevant views and editors.

For more information on these options, press F1 on your keyboard to display dynamic context help.

Non-ConfidentialPDF file icon PDF versionARM DUI0446Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.