Optional configuration

This section includes details of the Linaro Forge Options window (Preferences on Mac OS X), which allows you to edit the system, job submission, code viewer settings, and appearance.

Access the Linaro Forge Options or Preferences window

  • To open the Options window, select File ‣ Options.

  • To open the Preferences window (Mac OS X), select File ‣ Preferences.

System

This section provides details of the optional system settings that you can apply to Linaro Forge.

Warning

To prevent unauthorized users modifying sensitive files and directories, and introducing unsafe code into your environment, ensure that you assign only the minimum permissions that are required, and avoid group or world-writable permissions.

Name

Description

MPI Implementation

Allows you to identify which MPI implementation you are using.

Override default mpirun path

Allows you to override the path to the mpirun (or equivalent) command.

Select Debugger

Specifies to Linaro DDT the underlying debugger to use. Unless a specific debugger is required, leave this as Automatic.

On Linux systems, Linaro Forge ships with the following versions of the GNU GDB debugger: GDB 12.1, GDB 13.1 and GDB 16.1

Linaro recommends the GDB 16.1 debugger for Linaro DDT. This recommended default is selected automatically when you select Automatic (recommended) in Options ‣ System Settings.

Create Root and Workers groups automatically

If this option is selected, Linaro DDT automatically creates a Root group for rank 0, and a Workers group for ranks 1-n when you start a new MPI session.

Heterogeneous system support

Linaro DDT has support for running heterogeneous MPMD MPI applications where some nodes use one architecture and other nodes use another architecture.

This requires a little preparation of your installation.

  • You must have a separate installation of Linaro DDT for each architecture. The architecture of the machine running the Linaro Forge GUI is called the host architecture.

  • You must create symbolic links from the host architecture installation of Linaro Forge to the other installations for the other architectures. For example, with a 64-bit x86_64 host architecture (running the GUI) and some compute nodes running the 32-bit i686 architecture:

    ln -s /{installation-directory(i686)}/libexec/forge-backend \
/{installation-directory(x86_64)}/bin/forge-backend.i686

Enable CUDA software preemption

Allows debugging of CUDA kernels on a workstation with a single GPU.

Default groups file

Entering a file here allows you to customize the groups displayed by Linaro DDT when starting an MPI job. If you do not specify a file, Linaro DDT creates the default Root and Workers groups if the previous option is selected.

Note

You can create a groups file while your program is running by right-clicking the Process groups panel and selecting Save groups.

Attach hosts file

When attaching, Linaro DDT fetches a list of processes for each of the hosts listed in this file. See Attach to running programs for more details.

Job submission

This section of the Options window allows you to configure to use a custom command, or submit your jobs to a queuing system. For more information on this, see Integration with queuing systems.

Code viewer settings

This section allows you to configure the appearance of the code viewer, which is used to display your source code while debugging.

Name

Description

Tab size

Sets the width of a tab character in the source code display. A width of 8 means that a tab character has the same width as 8 space characters.

Font name

The name of the font used to display your source code. Linaro recommends that you use a fixed-width font.

Font size

The size of the font used to display your source code.

External Editor

This is the program Linaro Forge executes if you right-click in the code viewer and choose Open file in external editor. This command launches a graphical editor. If no editor is specified, Linaro Forge attempts to launch the default editor that is configured in your desktop environment.

Color Scheme

Color palette to use for the code viewer background, text, and syntax highlighting. Defined in Kate syntax definition format in the resource/styles directory of the install.

Visualize Whitespace

Enables or disables this display of symbols to represent whitespace. Useful for distinguishing between space and tab characters.

Warn about potential programming errors

This setting enables or disables the use of static analysis tools that are included with the installation. These tools support F77, C, and C++, and analyze the source code of viewed source files to discover common errors, but they can cause heavy CPU usage on the system running the Linaro Forge user interface. You can disable this by clearing this option.

Appearance

This section allows you to configure the graphical style of Linaro Forge, as well as fonts and tab settings for the code viewer.

Name

Description

Look and Feel

This determines the general graphical style of Linaro Forge. This includes the appearance of buttons, context menus.

Override System Font Settings

This setting can be used to change the font and size of all components in (except the code viewer).