This section includes details of the Arm® Forge Options window (Preferences on Mac OS X), which allows you to edit the system, job submission, code viewer settings, and appearance.
This section provides details of the optional system settings that you can apply to Arm® Forge.
Note
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 Arm® DDT the underlying debugger to use. Unless a specific debugger is required, leave this as Automatic. On Linux systems, Arm® Forge ships with the following versions of the GNU GDB debugger: GDB 7.6.2, GDB 8.2, GDB 10.0, GDB 11.1 and GDB 12.1. Arm recommends the GDB 12.1 debugger for Arm® DDT. This recommended default is selected automatically when you select Automatic (recommended) in . |
| Create Root and Workers groups automatically | If this option is selected, Arm® 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 | Arm® 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.
|
| Enable CUDA software pre-emption | Allows debugging of CUDA kernels on a workstation with a single GPU. |
| Ḏefault groups file | Entering a file here allows you to customize the groups displayed by Arm® DDT when starting an MPI job. If you do not specify a file, Arm® 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, Arm® DDT fetches a list of processes for each of the hosts listed in this file. See Attach to running programs for more details. |
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.
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. Arm 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 Arm® 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, Arm® Forge attempts to launch the default editor that is configured in your desktop environment. |
| Colour 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 Arm® Forge user interface. You can disable this by clearing this option. |
This section allows you to configure the graphical style of Arm® Forge, as well as fonts and tab settings for the code viewer.
| Name | Description |
|---|---|
| Look and Feel | This determines the general graphical style of Arm® 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). |