3.19 Configuring the debugger path substitution rules

During the debugging process, the debugger attempts to open the corresponding source file when execution stops at an address in the image or shared object.

The debugger might not be able to locate the source file when debug information is loaded because:

Therefore, you must modify the search paths used by the debugger when it executes any of the commands that look up and display source code.

To modify the search paths:

Procedure

  1. Open the Path Substitution dialog box.
    • If a source file cannot be located, a warning is displayed in the C/C++ editor. Click the Set Path Substitution option.
    • In the Debug Control view, select Path Substitution from the view menu.

      Note:

      You must be connected to your target to access the Path Substitution menu option.
      Figure 3-12 Set Path Substitution
      Set Path Substitution


  2. Click on the required toolbar icons in the Path Substitution dialog box:
    Figure 3-13 Path Substitution dialog box
    Path Substitution dialog box


    • Add Path - Add a path using the Edit Substitute Path dialog box.
      Figure 3-14 Edit Substitute Path dialog box
      Edit Substitute Path dialog box


      1. Image Path - Enter the original path for the source files or Select... a compilation path.
      2. Host Path - Enter the current location of the sources. Click File System... to locate the source files in an external folder or click Workspace... to locate the source files in a workspace project.
      3. Click OK to accept the changes and close the dialog.
    • Delete Path - Delete an existing path.
      1. Select the path that you want to delete in the Path Substitution dialog box.
      2. Click Delete Path to delete the selected path.
      3. Click OK to accept the changes and close the dialog box.
    • Edit Path - Edit an existing path.
      1. Select the path that you want to edit in the Path Substitution dialog box.
      2. Click Edit Path to edit the path in the Edit Substitute Path dialog box.
      3. Make your changes and click OK to accept the changes and close the dialog box.
    • Duplicate substitution rules - Duplicate substitution rules.
      1. Select the path that you want to duplicate in the Path Substitution dialog box.
      2. Click Duplicate substitution rules to display the Edit Substitute Path dialog box.
      3. Make your changes and click OK to accept the changes and close the dialog box.
    • If required, you can change the order of the substitution rules.
  3. Click OK to pass the substitution rules to the debugger and close the Path Substitution dialog box.
Non-ConfidentialPDF file icon PDF versionARM DUI0446Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.