| |||
| Home > DS-5 Debug perspective and views > Debug Configurations - Files tab | |||
The Files tab in the Debug Configurations dialog box enables you to select debug versions of the application file and libraries on the host that you want the debugger to use. You can also specify the target file system folder to which files can be transferred if required.
Options in the Files tab are dependent on the type of platform and debug operation that you select.
These options enable you to configure the target file system and select files on the host that you want to download to the target or use by the debugger. The Files tab options available for each Debug operation are:
Table 2. Files tab options available for each Debug operation
Download and debug application | Debug target resident application | Connect to already running gdbserver | Debug via DSTREAM/RVI | Debug and ETB Trace via DSTREAM/RVI | |
|---|---|---|---|---|---|
Application on host to download | Yes | - | - | Yes | Yes |
Application on target | - | Yes | - | - | - |
Target download directory | Yes | - | - | - | - |
Target working directory | Yes | Yes | - | - | - |
Load symbols from file | Yes | Yes | Yes | Yes | Yes |
Other file on host to download | Yes | - | - | - | - |
Path to target system root directory | Yes | Yes | Yes | - | - |
Save the current configuration. This does not connect to the target.
Undo any changes and revert to the last saved configuration.
Connect to the target and close the Debug Configurations dialog box.
Close the Debug Configurations dialog box.
The Files options available depend on the debug operation you selected on the Connection tab. The possible Files options are:
Specify the application image file on the host that you want to download to the target:
enter the host location and file name in the field provided
click on File System... to locate the file in an external directory from the Eclipse workspace
click on Workspace... to locate the file in an project directory or sub-directory within the Eclipse workspace.
For example, to download the stripped (no debug) Gnometris
application image select the gnometris/stripped/gnometris file.
Select Load symbols to load the debug symbols from the specified image.
Select Enable on-demand loading to specify how you want the debugger to load debug information. Enabling this option can provide a faster load and use less memory but debugging might be slower.
Specify the location of the application on the target. gdbserver uses this to launch the application.
For example, to use the stripped (no debug) Gnometris application
image when using a model and VFS is configured to mount the host
workspace as /writeable on the target, specify
the following in the field provided:
/writeable/gnometris/stripped/gnometris.
If the target has a preloaded image, then you might have to specify the location of the corresponding image on your host.
The debugger uses the location of the application image on the target as the default current working directory. To change the default setting for the application that you are debugging, enter the location in the field provided. The current working directory is used whenever the application references a file using a relative path.
Specify the application image containing the debug information to load:
enter the host location and file name in the field provided
click on File System... to locate the file in an external directory from the workspace
click on Workspace... to locate the file in a project directory or sub-directory within the workspace.
For example, to load the debug version of Gnometris you must
select the gnometris application image that
is available in the gnometris project root directory.
Select Enable on-demand loading to specify how you want the debugger to load debug information. Enabling this option can provide a faster load and use less memory but debugging might be slower.
Although you can specify shared library files here, the usual method is to specify a path to your shared libraries with the Shared library search directory option on the Debugger tab.
Specify other files that you want to download to the target:
Enter the host location and file name in the field provided.
Click on File System... to locate the file in an external directory from the workspace.
Click on Workspace... to locate the file in a project directory or sub-directory within the workspace.
For example, to download the stripped (no debug) Gnometris
shared library to the target you can select the gnometris/stripped/libgames-support.so file.
Specifies the system root directory to search for shared library symbols.
The debugger uses this directory to search for a copy of the debug versions of target shared libraries. The system root on the host workstation must contain an exact representation of the libraries on the target root filesystem.
If this field is not specified, the debugger uses the location of the application image on the target as the default current working directory. To change the default setting for the application that you are debugging, enter the location in the field provided. The current working directory is used whenever the application refers to a file using a relative path.
To
remove a resource from the configuration settings, click this button
next to the resource that you want to remove.
To
add a new resource to the file settings, click this button and then configure
the options as required.
Configuring an Event Viewer connection to a bare-metal target
ARM® DS-5™ Getting Started with DS-5:
ARM® DS-5™ Using Eclipse: