11.39 Debug Configurations - Files tab

Use the Files tab in the Debug Configurations dialog box 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.

Note

Options in the Files tab depend on the type of platform and debug operation that you select.
Files
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 11-1 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 - -
Apply
Save the current configuration. This does not connect to the target.
Revert
Undo any changes and revert to the last saved configuration.
Debug
Connect to the target and close the Debug Configurations dialog box.
Close
Close the Debug Configurations dialog box.
Figure 11-45 Files tab (Shown with file system configuration for an application on an FVP)
Files tab (Shown with file system configuration for an application on an FVP)

Files options summary

The Files options available depend on the debug operation you selected on the Connection tab. The possible options are:
Application on host to download
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 a 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.
Project directory
Specify the Android project directory on the host:
  • Enter the host location in the field provided.
  • Click on File System... to locate the project directory in an external location from the Eclipse workspace.
  • Click on Workspace... to locate the project directory from within the Eclipse workspace.
APK file
Specify the Android APK 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 a project directory or sub-directory within the Eclipse workspace.
Process
This field is automatically populated from the AndroidManifest.xml file.
Activity
This field is automatically populated from the AndroidManifest.xml file.
Application on target
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.
Target download directory
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.
Load symbols from file
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.
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.

Note

Load symbols from file is selected by default.
Add peripheral description files from directory
A directory with configuration files defining peripherals that must be added before connecting to the target.
Other file on host to download
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.
Path to target system root directory
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.
Target working directory
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.
Remove this resource file from the list
To remove a resource from the configuration settings, click this button next to the resource that you want to remove.
Add a new resource to the list
To add a new resource to the file settings, click this button and then configure the options as required.
Related concepts
6.10.2 About debugging a Linux kernel
Non-ConfidentialPDF file icon PDF versionARM DUI0446W
Copyright © 2010-2015 ARM. All rights reserved.