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.

Note

Options in the Files tab are dependent 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 3. Files tab options available for each Debug operation

 

Download and

debug application

Debug target

resident application

Connect to already

running gdbserver

Debug via DSTREAM/RVIDebug and ETB Trace via DSTREAM/RVI

Application on host to download

Yes--YesYes

Application on target

-Yes---

Target download directory

Yes----

Target working directory

YesYes---

Load symbols from file

YesYesYesYesYes

Other file on host to download

Yes----

Path to target system root directory

YesYesYes--

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 61. File system configuration for an application on a model

File system configuration for an application on a model

Show/hideFiles options summary

The Files options available depend on the debug operation you selected on the Connection tab. The possible Files 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 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.

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 an 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.

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.

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 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.

Show/hideSee also

Copyright © 2010-2012 ARM. All rights reserved.ARM DUI 0446I
Non-ConfidentialID022212