4.18.2. Adding a source mapping

If an image contains source path details, but that source path does not exist on your workstation, you can specify a source mapping. This maps the source path information in your image to the source path on your workstation.

To add a source mapping for a loaded image:

  1. Select Set Source Search Path... from the Debug menu to display the Source Search and Mappings dialog box. Figure 4.14 shows an example.

  2. Click the Source Mapping tab.

  3. Click New to display the New Mapping dialog box. Figure 4.16 shows an example.

    Figure 4.16. New Mapping dialog box

    New Mapping dialog box

  4. Specify the Original Path (that is, the path to the original source tree for the image). To do this, either:

    • enter the pathname in the field

    • click the open file button to locate the required file.

  5. Specify the Mapped Path (that is, the path to the new source tree for the image). To do this, either:

    • enter the pathname in the field

    • click the open file button to locate the required file.

  6. Click OK.

    The source mapping is added to the list of mappings, as shown in Figure 4.17.

    Figure 4.17. Source Mapping tab

    Source Mapping tab

  7. If your sources are distributed between a number of directories, then repeat the previous steps for each directory.

  8. When you have specified all the source mappings for the image, click OK to close the Source Search and Mappings dialog box.

Note

The Object Search Path and Object Mapping tabs are used when debugging OS-aware applications, and provides mappings to objects, such as shared libraries.

The search mappings that you define are saved in a settings file that is stored in the same location as the image. This file has the same name as your image, and has the .apr file extension. For example, if you are using the dhrystone.axf image, the settings file is called dhrystone.axf.apr. The settings in this file are re-applied when you next load the image.

See also

  • RealView Debugger RTOS Guide.

Copyright © 2002-2009 ARM Limited. All rights reserved.ARM DUI 0153K
Non-Confidential