The Automatic Path Mapping feature focuses on reducing as much as possible the manual steps required by the user to set up the path mapping settings in order to support source level debugging.
For automatic path mapping:
- In the CodeWarrior Projects view, expand Binaries folder and right-click the *.eld file.
- Choose Properties from the shortcut menu that appears.
The Properties for *.eld dialog appears.
- Select Path Mappings on the left side of the dialog.
The Path Mappings page appears. This page displays every path mapping settings for the launch configurations associated with a project.
You can edit either a single set of settings for all launch configurations associated with a project or the settings for a given launch configuration by choosing the appropriate value from the Launch Configuration pop-up menu.
Under each path mapping, the table displays a list of source files that exist in the binary executable that share the same source mapping prefix. In the Local Path column, a green sign (
) appears if the file exists after being mapped by the destination path or a red (
) if it does not. Also, the local path itself is displayed in red if it does not exist on the local file system.A default folder named Files Not Mapped is created if you explicitly remove existing mappings. All unmapped files that are not found on the file system are automatically shown under this folder.
The following table describes various options available in the Path Mappings page.
Table 1. Automatic path mappings options Options Description Auto Correct When clicked, iterates automatically through all the files not found on the file system and attempt to group them with their common prefix. This action often generates satisfactory results from the source files listed in the binaries so that the manual steps required by the user are kept at a minimum. Add Allows you to create a new Path Mapping entry. If any paths are selected, the dialog will be pre-initialized with their common prefix. Remove Allows you to remove any path mapping or default entry. Edit Allows you to change the values of the selected path mapping entry. Editing non-path mapping entry is not supported. Up Allows you to reorder the entries by moving the selected entry up in the list. Note that path mappings need always to be grouped together, and as such moving up the top most path mapping will always move its siblings above the preceding entry as well. Down Allows you to reorder the entries by moving the selected entry down in the list. Note that path mappings need always to be grouped together, and as such moving down the bottom most path mapping will always move its siblings below the following entry as well. Restore Defaults Resets the launch configuration path mappings settings to their previous values, including the library path mapping automatically generated by the APM plug-in. Note: If you create a new path mappings manually from the source lookup path, the source files are automatically resorted to their most likely path mapping parent. - Click OK.
The Path Mappings dialog closes.