TotalView X Resources
- You can override some of the resources with command-line options for the totalview command, as described in TotalView Command Syntax.
Note: You can specify an X resource on the command line by using the -resource=value command-line option. For example, to set "totalview*stopAll" to false, you could use the following command-line option: -stopAll=false. Note that the string "totalview*" is omitted from the command line.
Window Locations
- Values for the location of windows are expressed as:
=widthxheight+x+y
where width is the width of the window in pixels, height is the height of the window in pixels, x is the distance from the upper-left corner of the window to the left screen edge in pixels, and y is the distance from the upper-left corner of the window to the top screen edge in pixels. A value of -1 for x or y indicates that the window should be centered in the screen with respect to the x-axis or y-axis. If desired, you can express x or y as negative numbers to indicate the distance from the lower-right corner of the window to the bottom screen edge or right screen edge instead of the distance from the upper-left corner. A value of zero (0) indicates that TotalView should use the default value. Also, you can supply just the size (width and height), and TotalView will use the default location (x and y) with it.
- As an example, the expression =0x0-1+20 uses the default width and height, centers the window horizontally, and places the window 20 pixels down from the top of the screen. The expression =330x120+20-20 makes the window 330 pixels wide by 120 pixels high and places the window 20 pixels from the left edge of the screen and 20 pixels up from the bottom edge of the screen.
totalview*autoRetraceAddresses
{on | off}
- If on (default), TotalView will retrace the sequence of dive operations performed in a Variable Window and recompute a new address for the variable. If off, TotalView does not retrace addresses.
totalview*backgroundColor
color
Default: white
- Sets the general background color to color.
totalview*compilerVars
{true | false}
- Compaq Tru64 UNIX and SGI only. If false (default), TotalView does not show variables created by the Fortran compiler. If true, TotalView shows variables created by the Fortran compiler and the variables in the user's program.
- Some Fortran compilers (Compaq f90/f77 and SGI 7.2 compilers) output debug information that describes variables that the compiler itself has invented for purposes such as passing the length of character*(*) variables. By default, TotalView suppresses the display of these compiler-generated variables; however, setting totalview*compilerVars to true tells TotalView to display these variables. This could be useful if you are looking for a corruption of a runtime descriptor or are writing a compiler.
Override with: -compiler_vars option (overrides false)
-no_compiler_vars option (overrides true)
totalview*compileExpressions
{true | false}
- Compaq Alpha UNIX and IBM AIX (default true), and MIPS IRIX (default false) platforms only. If true, TotalView enables compiled expressions. If false, TotalView disables compiled expressions and interprets them instead.
totalview*cTypeStrings
{true | false}
- If false (default), TotalView's type string extensions are used when displaying the type strings for arrays. If true, C type string syntax are used when displaying arrays.
totalview*displayAssemblerSymbolically
{on | off}
- If off (default), display assembler locations as hexadecimal addresses. If on, assembler locations are displayed as "label+offset."
totalview*DPVMDebugging
{true | false}
- Compaq Tru64 UNIX only.
- If false (default), disables support for debugging the Digital UNIX implementation of Parallel Virtual Machine (DPVM) applications. If true, enables support for debugging DPVM applications.
Override with: -dpvm option (overrides false)
-no_dpvm option (overrides true)
totalview*font
fontname
Default: fixed
- Specifies the font used by the TotalView debugger. Use the X Windows-supplied application xlsfonts to list the names of available fonts.
totalview*foregroundColor
color
Default: black
- Sets the general foreground color (that is, the text color) to color.
totalview*globalTypenames
{true | false}
- If true (default), specifies that TotalView can assume that type names are globally unique within a program and that all type definitions with the same name are identical. In C++, the standard asserts that this must be true for standard conforming code.
- If this option is true, TotalView attempts to replace an opaque type (struct foo *p;) declared in one module with an identically named defined type (struct foo { ... };) in a different module.
- If TotalView has read the symbols for the module containing the non-opaque type definition, then when displaying variables declared with the opaque type, TotalView will automatically display the variable by using the non-opaque type definition.
- If false, TotalView will not assume that type names are globally unique within a program. You should specify this option if your code has different definitions of the same named type since, otherwise, TotalView is likely to pick the wrong definition to substitute for an opaque type.
Override with: -global_types option (overrides false)
-no_global_types option (overrides true)
totalview*hpf
{true | false}
- If true (default, if HPF debugging has been licensed), enables debugging at the HPF source level.
- Setting this X resource to false causes TotalView to ignore .stx and .stb files, and therefore to debug HFP code at the intermediate (Fortran 77) level.
Override with: -hpf option (overrides false)
-no_hpf option (overrides true)
totalview*hpfNode
{true | false}
- If false (default), the node on which an HPF distributed array element resides is not displayed in the Process Window.
- The node display can be toggled in each Variable Window by using the Toggle Node Display option in the Process Window menu.
Override with: -hpf_node option (overrides false)
-no_hpf_node option (overrides true)
totalview*kccClasses
{true | false}
- If set to true, (default) TotalView will convert structure definitions output by the KCC compiler into classes that show base classes and virtual base classes in the same way as other C++ compilers. When set to false, the debugger will not convert structure definitions output by the KCC compiler into classes. Virtual bases will show up as pointers rather than as the data.
- Unfortunately, the conversion has to be done by textual matching of the names given to structure members, so it can be confusing if you have structure component names that look to TotalView like KCC processed classes. However, the conversion is never performed unless TotalView believes that the code was compiled with KCC, because TotalView has seen one of the tag strings that KCC outputs, or because the user has asked for the KCC name demangler to be used. Also all of the recognized structure component names start with "_ _", and, according to the C standard, user code should not contain names with this prefix.
- Note that under some circumstances it is not possible to convert the original type names because there is no available type definition. For example, it may not be possible to convert "struct __SO_foo" to "struct foo", so in this case the "__SO_foo" type will be shown. This is only a cosmetic problem. (The "__SO__" prefix denotes a type definition for the nonvirtual components of a class with virtual bases).
- Since KCC outputs no information on the accessibility of base classes ("private", "protected", "public"), TotalView is unable to provide this information.
totalview*parallelAttach
{ yes | no | ask }
- Tells TotalView what it should do when it can automatically attach to processes. Your choices are as follows:
- yes: Attach to all started processes.
- no: Do not attach to any started processes.
- ask: Display a dialog box listing the processes to which TotalView can attach and let the user decide which ones TotalView should attach to.
totalview*parallelStop
{ yes | no | ask }
- Tells TotalView if it should automatically run processes when your program launches them. Your choices are as follows:
- yes: Stop the processes before they begin executing.
- no: Do not interfere with the processes; that is , let them run.
- ask: Display a question box asking what it should do.
totalview*patchAreaAddress
address
- Allocates the patch space dynamically at the given address. See Allocating Patch Space for Compiled Expressions.
totalview*patchAreaLength
length
- Sets the length of the dynamically allocated patch space to the specified length. See Allocating Patch Space for Compiled Expressions.
totalview*popAtBreakpoint
{on | off}
- If on, sets the Open (or raise) process window at breakpoint check box to be selected by default. If off (default), sets that check box to be deselected by default. See Handling Signals.
Override with: -pop_at_breakpoint option (overrides off)
-no_pop_at_breakpoint option (overrides on)
totalview*popOnError
{on | off}
- If on (default), sets the Open process window on error signal check box within the File > Preference's Option Page to be selected by default. If off, sets that check box to be deselected by default. See Handling Signals for more information.
Override with: -pop_on_error option (overrides off)
-no_pop_on_error option (overrides on)
totalview*pvmDebugging
{true | false}
- If false (default), disables support for debugging the ORNL implementation of Parallel Virtual Machine (PVM) applications. If true, enables support for debugging PVM applications.
Override with: -pvm option (overrides false)
-nopvm option (overrides true)
totalview*searchCaseSensitive
{on | off}
- If off (default), searching for strings is not case sensitive. If on, searches are case- sensitive.
totalview*searchPath
dir1[,dir2,...]
- Specifies a list of directories for the debugger to search when looking for source and object files. This resource serves the same purpose as the File > Search Path command in the Process Window (see Setting Search Paths). If you use multiple lines, place a backslash (\) at the end of each line, except for the last line.
totalview*signalHandlingMode
action_list
- Modifies the way in which TotalView handles signals. An action_list consists of a list of signal_action descriptions, separated by spaces:
signal_action[signal_action] ...
A signal_action description consists of an action, an equal sign (=), and a list of signals:
- action=signal_list
An action can be one of the following: Error, Stop, Resend, or Discard. For more information on the meaning of each action, refer to Handling Signals.
- A signal_list is a list of one or more signal specifiers, separated by commas:
- signal_specifier[,signal_specifier] ...
A signal_specifier can be a signal name (such as SIGSEGV), a signal number (such as 11), or a star (*), which specifies all signals. We recommend using the signal name rather than the number because number assignments vary across UNIX versions.
- The following rules apply when you are specifying an action_list:
- If you specify an action for a signal in an action_list, TotalView changes the default action for that signal.
- If you do not specify a signal in the action_list, TotalView does not change its default action for the signal.
- If you specify a signal that does not exist for the platform, TotalView ignores it.
- If you specify an action for a signal twice, TotalView uses the last action specified. In other words, TotalView applies the actions from left to right.
If you need to revert the settings for signal handling to TotalView's built-in defaults, use the Defaults button in the File > Signals dialog box.
- For example, to set the default action for the SIGTERM signal to Resend, you specify the following action list:
"Resend=SIGTERM"
As another example, to set the action for SIGSEGV and SIGBUS to Error, the action for SIGHUP and SIGTERM to Resend, and all remaining signals to Stop, you specify the following action list:
"Stop=* Error=SIGSEGV,SIGBUS Resend=SIGHUP,SIGTERM"
This action list shows how TotalView applies the actions from left to right.
- Sets the action for all signals to Stop.
- Changes the action for SIGSEGV and SIGBUS from Stop to Error.
- Changes the action for SIGHUP and SIGTERM from Stop to Resend.
totalview*sourcePaneTabWidth
n
Default: 8
- Sets the width of the tab character that is displayed in the Source Pane. For example, if your source file uses a tab width of 4, set n to 4.
totalview*spellCorrection
{verbose | brief | none}
- When you use the Function or File... or Variable... commands in the Process Window or edit a type string in a Variable Window, the debugger checks the spelling of your entries. By default (verbose), the debugger displays a dialog box before it corrects spelling. You can set this resource to brief to run the spelling corrector silently. (The debugger makes the spelling correction without displaying it in a dialog box first.) You can also set this resource to none to disable the spelling corrector.
totalview*useInterface
name
- Sets the interface name that the server uses when it makes a callback. For example, on an IBM PS2 machine, the following resource setting sets the callback to use the hardware option:
- totalview*useInterface:css0
- However, TotalView will let you use any legal inet interface name. (You can obtain a list of the interfaces if you use the netstat -i command.)
totalview*userThreads
{true | false}
- If set to true (default), enables handling of user-level (M:N) thread packages on systems where two-level (kernel and user) thread scheduling is supported. If set to false, TotalView disables handling of user-level (M:N) thread packages. Disabling thread support may be useful in situations where you need to debug kernel-level threads, but in most cases, this option is of little use on systems where two-level thread scheduling is used.
Override with: -user_threads option (overrides false)
-no_user_threads option (overrides true)
totalview*useTransientFor
{on | off}
- If off, TotalView sets the "override redirect" property for windows. This property does not let you use the window manager to perform operations such as raising and lowering dialog boxes. If you use an advanced window manager, you can use the on option (default) which lets TotalView use "transient-for" type windows. This property allows you to use the window manager to perform operations on dialog boxes. If you are using an X11R4 or more recent server and window manager, you should use the on option. If you're using Compaq's window manager, you should use the off option.
totalview*verbosity
{silent | error | warning | info}
Default: info
- Sets the verbosity level of TotalView-generated messages.
