Preferences

Topics include:

Please see the online documentation for the additional preference information.

Opening the PTP Preferences

To open the Preferences dialog, select:

Next, expand Parallel Tools in the list of preferences pages on the left side and choose the component's preferences you wish to change. The following image shows all available components:

Parallel Tools Preference Page

This is the main preferences page for PTP. Available preferences are:

Temporary output directory
Temporary directory to use to save process output
Console buffer size (lines)
Number of lines of output from each process to save (0 means infinite)

Debug Preferences Page (Parallel Tools > Debug)

This is the main parallel debugger preferences page. These are preferences that apply to any parallel debugger.

Default settings

These preferences control some debugger default behavior

Show full paths on breakpoint (default disabled)
Use the full path to the source file when displayed in the debugger Breakpoint view
Register process 0 by default (default enabled)
Will register process 0 with the Debug view when the parallel debugger starts. This is required to enable Eclipse to switch automatically to the PTP Debug perspective when a debugger breakpoint is hit.

Communication

These are preferences relating to the communication between Eclipse and the external parallel debugger. They do not normally need to be changed.

Command timeout (ms) (default 60000)
This specifices the period Eclipse waits after sending a command to the external debugger. If no response is received the debug session will be terminated.

Variable

These variables control the action of the debugger to update variable information.

The debugger is suspended (default enabled)
The debugger allows variable values to be displayed in tooltip popups when the mouse hovers over a process in the Parallel Debug view. Enabling this option will update all the values each time the process is suspended. When this option is disabled, the value will be updated when the tooltip popup is displayed.
Job or Set is changed (default disabled)
Variable values will be updated when the current job or set is changed.

SDM (Scalable Debug Manager) Preferences (Parallel Tools > Debug > SDM)

These are preferences for controlling the behavior of the scalable debug manager, which is the server component of the parallel debugger. They do not normally need to be changed.

Debugger launch preferences

These preferences control how the debugger behaves when it is launched. They do not normally need to be altered.

Backend debugger (default gdb-mi)
The name of the backend debugger to use when debugging the application. This is an internal name known by the SDM, not the name of the debugger itself. Currently only gdb using the MI mode is supported.
Path to gdb executable (default empty)
If the backend debugger (e.g. gdb) is not located in a standard directory then this field can be used to specify an alternate location.
Path to SDM executable (default empty)
Sets the preferred path to the SDM executable. This will be used to populate the Debug tab on the launch configuration.

SDM debugging options

These preference allow the SDM operation to be debugged. They are normally only used by PTP developers.

Enable SDM debugging
This turns on debugging of the SDM. Additional options can be set to control the type and amount of debugging information that is generated.
Enable SDM client debugging
Enables debugging of the SDM Eclipse client. Additional options can be set to control the type and amount of debugging information that is generated.

External Tools Preferences Page (Parallel Tools > External Tools)

This is a category for configuring external tools that are provided using the ETFw extensions. The contents may vary based on which (optional) ETFw features you have installed For more information see the ETFw wiki page.

External Tool Configuration

These preferences are used to configure ETFw

Tool Definition File (default empty)
The name of a file containing the ETFw XML configuration.

Feedback View (Parallel Tools > External Tools > Feedback View)

The Feedback view preferences page handles cases where extensions are installed that utilize the Feedback view.

Preferences for Feedback View

These preferences are used to configure the feedback view. See Feedback view for more information.

Parallel Language Development Tools (PLDT) Preferences

See the help for PLDT

Sync Preferences

The preferences page for Synchronized projects includes setting defaults for sync filtering.

Git is used in synchronized projects implementation. If Git is not available in your path on the remote machine, it can be specified here. Git location can be changed for each connection.

 

Back to Top | Back to Table of Contents