This variable is defined only on AIX, and is a synonym for the platform-independent variable TV::use_fast_wp, providing TotalView script backward compatibility. See TV::use_fast_wp for more information.

This variable is defined only on AIX, and is a synonym for the platform-independent variable TV::use_fast_trap, for TotalView script backward compatibility. See TV::use_fast_trap for more information.

If true, TotalView asks about stopping processes that use the dlopen or load (AIX only) system calls dynamically load a new shared library.

If false, TotalView does not ask about stopping a process that dynamically loads a shared library.

Indicates the number of array elements to display when the TV::auto_array_cast_enabledvariable is true. This is the variable set by the Bounds field of the Pointer Dive Page in the File > Preferences dialog box.

When true, TotalViewautomatically dereferences a pointer into an array. The number of array elements is indicated in the TV::auto_array_cast_bounds variable. This is the variable set by the Cast to array with bounds checkbox of the Pointer Dive Page in the File > Preferences dialog box.

Defines if and how to dereference C and C++ pointers when performing a View > Dive in All operation, as follows:

This is the variable set when you select the Dive in All element in the Pointer Dive Page of the File > Preferences dialog box.

Tells TotalView if and how it should dereference Fortran pointers when you perform a Dive in All operation, as follows:

This is the variable set when you select the Dive in All element in the Pointer Dive Page of the File > Preferences dialog box.

Defines if and how to dereference C pointers when they are displayed, as follows:

This is the variable set when you select the initially element in the Pointer Dive Page of the File > Preferences dialog box.

Defines if and how to dereference Fortran pointers when they are displayed, as follows:

Defines if and how to dereference C pointers when you dive on structure elements:

This is the variable set when you select the from an aggregate element in the Pointer Dive Page of the File > Preferences dialog box.

Defines if and how to dereference Fortran pointers when they are displayed:

This is the variable set when you select the from an aggregate element in the Pointer Dive Page of the File > Preferences dialog box.

If true, TotalViewautomatically loads action points from the file named filename.TVD.v4breakpoints where filename is the name of the file being debugged. If false, breakpoints are not automatically loaded. If you set this to false, you can still load breakpoints using the Action Point > Load All or thedactions -load command.

If false, TotalView does not automatically read symbols if execution stops when the program counter is in a library whose symbols were not read. If true, TotalView reads in loader and debugging symbols. You would set it to false if you have prevented symbol reading using either the TV::dll_read_loader_symbols_only or TV::dll_read_no_symbols variables (or the preference within the GUI) and reading these symbols is both unnecessary and would affect performance.

If true, TotalView automatically writes information about breakpoints to a file named filename .TVD.v4breakpoints, where filename is the name of the file being debugged. Information about watchpoints is not saved.

TotalView writes this information when you exit from TotalView. If you set this variable to false, you can explicitly save this information by using the Action Point > Save All or thedactions-save command.

Contains the value of the “stop_all” property for newly created action points. This property defines additional elements to stop when a thread encounters this action point. You can also set this value using the -stop_all command-line option or the When barrier hit, stop value in the Action Points page of the File > Preferences dialog box. The values that you can use are as follows:

This variable is the same as the BARRIER_STOP_ALL variable.

Contains the value for the “stop_when_done” property for newly created action points. This property defines additional elements to stop when a barrier point is satisfied. You can also set this value using the -stop_when_done command-line option or the When barrier done, stop value in the Action Points page of the File > Preferences dialog box. The values you can use are:

In all cases, TotalView releases the satisfaction set when the barrier is satisfied.

This variable is the same as the BARRIER_STOP_­WHEN_DONE variable.

Defines the base timeout period used to execute a bulk launch.

If true, uses bulk launch features when automatically launching the TotalView Debugger Server (tvdsvr) for remote processes.

Defines the incremental timeout period to wait for a process to launch when automatically launching the TotalView Debugger Server (tvdsvr) using the bulk server feature.

Defines the header line used in the first temporary file for a bulk server launch operation.

Defines the host line used in the first temporary file when performing a bulk server launch operation.

Defines the trailer line used in the first temporary file when performing a bulk server launch operation.

Defines the header line used in the second temporary file when performing a bulk server launch operation.

Defines the host line used in the second temporary file when performing a bulk server launch operation.

Defines the trailer line used in the second temporary file when performing a bulk server launch operation.

If true, uses C type string extensions to display character arrays; when false, uses string type extensions.

In concert with TV::checksum_libraries, controls whether TotalView checksums an image or uses a unique ID to determine the uniqueness of images across nodes in a parallel debugging session.

When true (the default), TotalView attempts to extract a unique ID from an image file before checksumming it.The extracted unique ID is a build ID on Linux, or a UUID on macOS. Note that not all image files contain a unique ID by default, but linkers can often add one, for example, by using the linker option --build-id. On macOS, a UUID is added to the image file by default, but the linker can control whether it adds a UUID, a checksum, or a random value.

When false, or if an image file does not contain a unique ID, or there is an error extracting the unique ID, TotalView falls back to checksumming to determine image file uniqueness, according to the setting on TV::checksum_libraries.

Controls image checksumming across nodes in a parallel debugging session. If set to auto (the default) or true, TotalView checksums on both the server and the client. If false, TotalView checksums the image only on the client, which should be used only if all image files across all the nodes in the debug session are known to be identical. Performing a checksum only on the client can improve startup times in some cases, depending on the system.

Even when set to auto or true, whether TotalView performs a checksum to validate images is impacted by the setting for TV::check_unique_id.

Allocates the patch space dynamically at the given address. See “Allocating Patch Space for Compiled Expressions”.

Sets the length of the dynamically allocated patch space to the specified length. See “Allocating Patch Space for Compiled Expressions” in the Classic TotalView User Guide.

Enables some Emacs-like commands for use while editing text in the CLI. These editing commands are always available in the CLI window of TotalView UI. However, they are available only within the stand­-alone CLI if the terminal in which it is running supports cursor positioning and clear-to-end-of-line. The commands that you can use are:

^A: Moves the cursor to the beginning of the line.

^B: Moves the cursor one character backward.

^D: Deletes the character to the right of cursor.

^E: Moves the cursor to the end of the line.

^F: Moves the cursor one character forward.

^K: Deletes all text to the end of line.

^N: Retrieves the next entered command (only works after ^P).

^P: Retrieves the previously entered command.

^R or ^L: Redraws the line.

^U: Deletes all text from the cursor to the beginning of the line.

Rubout or Backspace: Deletes the character to the left of the cursor.

When true, TotalViewenables compiled expressions. If false, TotalView interprets your expression.

On an IBM AIX system, you can use the -aix_use_fast_trap command line option to speed up the performance of compiled expressions. Check the Classic TotalView Release Notes to determine if your version of the operating system supports this feature.

(SGI only) When true, TotalView shows variables created by your Fortran compiler as well as the variables in your program. When false (which is the default), TotalView does not show the variables created by your compiler.

SGI 7.2 Fortran compilers write debugging information that describes variables the compiler created to assist in some operations. For example, it could create a variable used to pass the length of character*(*) variables. You might want to set this variable to true if you are looking for a corrupted runtime descriptor.

You can override the value set to this variable in a startup file with these command-line options:

When true, TotalViewkills attached processes and exits. When false, TotalView can sometimes better manage the way it kills parallel jobs when it works with management systems. This has been tested only with SLURM and may not work with other systems.

If you set the TV::ignore_control_c variable to true, TotalView ignores this variable.

A read-only string containing the copyright information displayed when you start the CLI and TotalView.

If true, the C++View facility allows the formatting of program data in a more useful or meaningful form than the concrete representation visible by default when you inspect data in a running program. For more information on using C++View, see C++View.

Indicates whether cuda debugging is currently enabled. This is a read-only variable.

Setting this variable overrides the C++demangler used by default. Note that this value is ignored unless you also set the value of the TV::force_default_­cplus_­demangler variable. The following values are supported:

Setting this variable overrides the Fortran demangler used by default. Note that this value is ignored unless you also set the value of the TV::force_default_f9x_demangler variable. The following values are supported:

Defines the format to use when displaying double-precision values. This is one of a series of variables that define how to display data. The format of each is similar:

{presentation format-1 format-2 format 3}

Defines the format to use when displaying extended floating point values such as long doubles.For a description of the contents of this variable, see TV::data_format_double.

Defines the format to use when displaying 8-bit integer values. For a description of the contents of this variable, see TV::data_format_double.

Defines the format to use when displaying 16-bit integer values. For a description of the contents of this variable, see TV::data_format_double.

Defines the format to use when displaying 32-bit integer values. For a description of the contents of this variable, see TV::data_format_double.

Defines the format to use when displaying 64-bit integer values. For a description of the contents of this variable, see TV::data_format_double.

Defines the format to use when displaying 128-bit integer values. For a description of the contents of this variable, see TV::data_format_double.

Defines the number of characters allowed in a long string.

Defines the format to use when displaying single precision, floating-point values. For a description of the contents of this variable, see TV::data_format_double.

Defines the maximum number of characters displayed for a string.

When true, TotalView catches thefork(), vfork(), and execve() system calls if your executable is linked with the dbfork library. See Linking with the dbfork Library.

When true, dbreak and dbarrier create pending action points, as if the -pending option had been set. The default is false. It is not recommended to set it to true because it suppresses catching input user errors.

For example, if you want to set a breakpoint on a function foo, but you typed voo instead, a pending breakpoint is immediately set on the function voo, which would not be your intention.

Names the compiled-in launch command appropriate for the platform.

Names the default subset specification listing MPI ranks to attach to when an MPI job is created or attached to.

When true, TotalView appends the target program’s stderr information to the file set in the GUI, by the -stderr command-line option, or in the TV::default_stderr_filename variable. If no pathname is set, the value of this variable is ignored. If the file does not exist, TotalView creates it.

Names the file to which to write the target program’s stderr information. If the file exists, TotalView overwrites it. If the file does not exist, TotalView creates it.

When true, TotalView writes the target program’s stderr information to the same location as stdout.

Names the file from which the target program reads stdin information.

When true, TotalView appends the target program’s stdout information to the file set in the GUI, by the -stdout command-line option, or in the TV::default_stdout_filename variable. If no pathname is set, the value of this variable is ignored. If the file does not exist, TotalView creates it.

Names the file to which to write the target program’s stdout information. If the file exists, TotalView overwrites it. If the file does not exist, TotalView creates it.

When true, TotalView displays assembler locations as label+offset. When false, these locations are displayed as hexadecimal addresses.

Defines a list of library files that will not result in a query to stop the process when loaded. This list contains a colon-separated list of prefixes. Also, TotalView will not ask if you would like to stop a process if:

Always reads loader and debugging symbols of libraries named within this variable.

This variable is set to a colon-separated list of library names. A name can contain the * (asterisk) and ? (question mark) wildcard characters, which have their usual meaning:

When TotalViewloads libraries named in this variable, it reads only loader symbols. Because TotalView checks and processes the names in TV::dll_read_all_symbols list before it processes this list, it ignores names that are in that list and in this one.

This variable is set to a colon-separated list of strings. Any string can contain the * (asterisk) and ? (question mark) wildcard characters, which have their usual meaning:

When TotalView loads libraries named in this variable, it does not read in either loader or debugging symbols. Because TotalView checks and processes the names in the TV::dll_read_loader_symbols_only lists before it processes this list, it ignores names that are in those lists and in this one.

This variable is set to a colon-separated list of strings. Any string can contain the * (asterisk) and ? (question mark) wildcard characters having their usual meaning:

Contains a colon-separated list of suffixes that stop the current process when it loads a library file with this suffix.

You must confirm that you want to stop the process:

When true, breakpoint specifications are reevaluated on every dlopen call (the default). When false, this variable enables dlopen event filtering in combination with the optional use of TV::dlopen_recalculate_on_match. For details on dlopen event filtering, see dlopen Options for Scalability.

Contains a glob-list of patterns used to match against the path name of a dlopened library. If TV::dlopen_always_recalculate is set to true, the value of this variable is ignored.

For a complete explanation of dlopen event filtering, including use-case examples, please refer to dlopen Options for Scalability.

When false, (the default), TotalView handles dlopen events in the target application serially. (Note that for parallel applications, handling dlopen events serially can degrade debugger performance.)

When true, TotalView attempts to handle dlopen events in parallel.

On non-MRNet platforms, or if MRNet is not enabled, then the value of this variable is ignored. For more information, see “Handling dlopen Events in Parallel”.

When true, a core file is created when an internal TotalView error occurs. This is used only when debugging TotalView problems. You can override this variable’s value by using the following command-line options:

When true, TotalView can use the DWARF global index sections (.debug_pubnames, .debug_pubtypes, .debug_typenames, etc.) in executable and shared library image files. It may be useful to set this flag to false if you have an image file that has incomplete global index sections, and you want to force TotalView to skim the DWARF instead, which may cause TotalView to slow down when indexing symbol tables. You can override this variable’s value by using the following command-line options:

Controls the amount of information displayed when you use the dwhere command. Here are three examples:

The arguments to this command are:

When true, TotalViewloads symbols from shared libraries. This variable is available on all platforms supported by Perforce Software. (This may not be true for platforms ported by others. For example, this feature is not available for Hitachi computers.) Setting this value to false can cause the dbfork library to fail because TotalView might not find the fork(), vfork(), and execve() system calls.

Defines the editor launch string command. The launch string substitution characters you can use are:

%E: The editor

%F: The display font

%N: The line number

%S: The source file

Names a variable that is already contained within your program’s environment. This is a read-only variable and is set by using the -env command-line option.For more information, see -env variable=value.

To set this variable from within TotalView, use the File > New Program or Process > Startup dialog boxes.

Defines how TotalView responds when a process being debugged calls execve(). This variable is comprised of an Tcl list of regexp and action pairs, called an exec-handling-list. The regexp contains the name of the parent process, and action defines an action for TotalView to take. For more information, see “Controlling fork, vfork, and execve Handling” in the Classic TotalView User Guide.

When a value greater than 0, allows TotalView to pickup threads created using the clone() system call. The supported values are:

0: TotalView does not follow clone() calls. This is most often used if problems occur.

1: TotalView follows clone() calls until the first pthread_create() call is made. This value is then set to 0.

2: TotalView follows clone() calls whenever they occur. Calls to clone() and pthread_create() can be interleaved. This may affect performance if the program has many threads.

3: (default) Like 2, TotalView follows clone() calls whenever they occur. However, TotalView uses a feature available on newer Linux systems to reduce the overhead.

When true, TotalView uses the demangler set in the TV::current_cplus_demangler variable. Set this variable only if TotalView uses the wrong demangler which may occur if you are using an unsupported compiler, an unsupported language preprocessor, or if your vendor has made changes to your compiler.

When true, TotalView uses the demangler set in the TV::current_fortran_demangler variable. Set this variable only if TotalView uses the wrong demangler which may occur if you are using an unsupported compiler, an unsupported language preprocessor, or if your vendor has made changes to your compiler.

Defines how TotalView responds when a process being debugged calls fork() or vfork() to attach to new processes. This variable is comprised of a Tcl list fork-handling-list of regexp and action pairs. The regexp contains the name of the parent process, and action defines an action for TotalView to take. For more information, see “Controlling fork, vfork, and execve Handling” in the Classic TotalView User Guide.

When true, TotalView can use the .gdb_index section in executable and shared library image files. It may be useful to set this to false if you have an image file that has an incomplete .gdb_index section and you want to force TotalView to skim the DWARF instead. You can override this variable’s value by using the following command-line options:

When true, TotalView assumes that type names are globally unique within a program and that all type definitions with the same name are identical. This must be true for standard-conforming C++ compilers.

If you set this option to 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, it automatically displays the variable by using the non-opaque type definition when displaying variables declared with the opaque type.

If false, TotalView does not assume that type names are globally unique within a program. Use this variable only if your code has different definitions of the same named type, since TotalView can pick the wrong definition when it substitutes for an opaque type in this case.

When true, TotalView checks for a .note.gnu.build-id NOTE section and a .gnu_debuglink section within your image files, in that order. If found, it looks for the file named in these sections. If false, TotalView ignores the contents of these sections, meaning that debug information from a separate file will not be loaded.

For more information, see Maintaining Debug Information Separate from an Executable.

This state variable contains a colon-separated search path that TotalView uses to search for separate debug information files using the build ID method.

Each component of this search path is expanded similarly to TV::gnu_debuglink_search_path. However, this variable is used only when searching for separate debug information files using the build ID method, and does not affect searching for separate debug information files using the debug link method.

A build ID is created using the --build-id option passed to the ld linker. By default, it is a SHA1,160-bit string (40 hex characters) stored in a .note.gnu.build-id NOTE section in an image file.

See the following URL for details: https://sourceware.org/gdb/onlinedocs/gdb/Separate-Debug-Files.html

For a build ID such as:

TotalView searches for:

.build-id/be/0e052ddd73fd5f3f15975ac02f4ca903d9bf77.debug relative to each expanded path component.

You can set or override this variable value in a startup file or with the command-line option
-gnu_debuglink_build_id_search_path.

These two boolean variables work in concert to define how to validate a separate debug info file, if one exists, against a base image file that references it. (See Maintaining Debug Information Separate from an Executable.) These settings may impact performance, depending on the system: Checksumming generally uses more resources than comparing build IDs, so the default setting attempts to compare the build IDs first before falling back and checksumming the separate debug info file.

Table 6 details how these settings work together.

Names the global directory containing separate debug files. For more information, see Maintaining Debug Information Separate from an Executable.

Defines the search path to use when searching for debug files. You can use substituting variables when assigning values:

You can set or override this variable value in a startup file or with the command-line option
-gnu_debuglink_search_path.

This variable affects only those cases where TotalView preloads the agent. It names the directory in which TotalView will look for the hia for a local job. The default is the value of TV::hia_local_installation_dir. Change this variable if you want TotalView to look for the agent in a different directory.

A read-only variable that names the directory where the hia distributed with the executing instance of TotalView is found.

This variable affects only those cases where TotalView preloads the agent. It names the directory on a remote host where TotalView will look for the hia that is to be used by the remote job. If the variable is not set, the server uses its default, which is the same as the default value of the server’s TV::hia_local_dir but is interpreted in the remote file system.

Deprecated.

Deprecated.

A read-only value that returns the architecture upon which TotalView is running.

When true, TotalView ignores Ctrl+C. This prevents you from inadvertently terminating the TotalView process. You would set this option to true when your program catches the Ctrl+C (SIGINT) signal. You may want to set File > Signals so that TotalView resends the SIGINT signal, instead of just stopping the program.

Contains a Tcl list of procedure names. TotalView invokes the procedures named in this list whenever it loads a new program. This could occur when:

Contains a true value if called while TotalView is being initialized. Your procedures would read the value of this variable so that code can be conditionally executed based on whether TotalView is being initialized. In most cases, this is used for code that should be invoked only while TotalView is being initialized. This is a read-only variable.

When true, ipv6 support is enabled. If false, ipv6 support is disabled.

When true, Clang / LLVM JIT (just-in-time compiled) code support is enabled through the GDB JIT debugging interface.

When JIT code is dynamically loaded into a process, TotalView reads the symbol table information for the JIT code and places it into a separate symbol table image. JIT images are handled similarly to dynamically loaded shared libraries, except that they are given a synthetic name starting with "@TEMP@JIT@". The JIT images appear after the executable and shared library images in the process' image list.

When JIT code is dynamically unloaded from a process, TotalView removes the corresponding JIT image from the process' image list.

Pending breakpoints can be created for the JIT code before it is dynamically loaded into the process. For example, if a pending breakpoint exists for a JIT code function called “compute_factorial”, execution stops when that JIT function is reached.

When false, Clang / LLVM JIT code support is disabled and TotalView does not hook JIT events or read JIT code symbol tables.

You can override this variable’s value by using the following command-line options:

Internal use only.

When true, TotalView converts structure definitions created by the KCC compiler into classes that show base classes and virtual base classes in the same way as other C++ compilers. When false, TotalView does not perform this conversion. In this case, TotalView displays virtual bases as pointers rather than as the data.

TotalView converts structure definitions by matching the names given to structure members. This means that TotalView may not convert definitions correctly if your structure component names look like KCC processed classes. However, TotalView never converts these definitions unless it believes that the code was compiled with KCC. (It does this when it sees one of the tag strings that KCC outputs, or when you use the KCC name demangler.) Because all recognized structure component names start with “_ _” and the C standard forbids this use, your code should not contain names with this prefix.

Under some circumstances, TotalView may not be able to convert the original type names because type definition are not available. For example, it may not be able to convert “struct __SO_foo” to “struct foo”. In this case, TotalView shows the “__SO_foo” type. This is just a cosmetic problem. (The “__SO__” prefix denotes a type definition for the nonvirtual components of a class with virtual bases).

Since KCC output does not contain information on the accessibility of base classes (private, protected, or public), TotalView cannot provide this information.

This is not currently used.

Names a Tcl function to run before TotalView kills a process. The contents of this variable is a list of pairs. For example:

If your Tcl procedure returns false, TotalView kills your process as you would expect. If the procedure returns true, TotalView takes no further action to terminate the process.

Any slave processes are killed before the master process is killed. If there is a kill_callback for the master process, it is called after the slave processes are killed. If there are kill_callbacks for the slave processes, they will be called before the slave is killed.

Specifies the directory to write library cache data.

Specifies the launch command.

Sets the interface name that the server uses when it makes a callback. For example, on an IBM PS2 machine, you would set this to css0. However, you can use any legal inet interface name. (You can obtain a list of the interfaces if you use the netstat -i command.)

(Sun only) This variable tells TotalView which local server it should launch. By default, TotalView finds the local server in the same place as the remote server. On Sun platforms, TotalView can launch a 32- and 64-bit version.

(Sun only) If TotalView will not be using the server contained in the same working directory as the TotalView executable, the contents of this string indicate the shell command that TotalView uses to launch this alternate server.

When true, TotalView displays MPI message queues when you are debugging an MPI program. When false, these queues are not displayed. Disable these queues only if something is overwriting the message queues, thereby confusing TotalView.

A Tcl regular expression matching the name of an mpibind program (or any program) that the MPI starter process launches, instead of directly launching the MPI application.

In some environments, the MPI starter process is configured to launch an intermediate program to bind the MPI processes to specific hardware resources, such as processor cores and GPUs, before executing the MPI application. A user may also want to launch an intermediate program that ultimately executes the MPI application.

Depending on the details of the MPI implementation, the presence of an intermediate program may cause the MPI debugging interface to incorrectly identify the name of the intermediate program as the name of the MPI application. When the MPI application name is incorrect, TotalView may not function correctly.

Setting this variable allows TotalView to identify the name of the intermediate program. If the executable name in the MPI debug information matches this regular expression, TotalView queries the operating system for the name of the executable to run to ensure that the name is correct.

For example, a user might launch an MPI application myMPIApp as follows:

Above, mpibind might be mistakenly identified as the name of the MPI application, instead of myMPIApp, which may cause TotalView to malfunction by naming the MPI processes incorrectly and making it impossible to load and save breakpoints.

See also the command line option -mpibind_regexp.

To set this variable:

When true, TotalView enables MRNet on platforms where it is supported (Linux-x86_64, Linux PowerLE, and Cray). To disable the MRNet infrastructure when debugging an MPI job, set this variable to false.

The start of the port range that MRNet attempts to use for listening sockets on Cray systems. This string is passed to MRNet instead of using the MRNET_PORT_BASE environment variable. This value is only used when TotalView uses MRNet on Cray systems.

Controls the use of an MRNet proxy server.

When true, TotalView creates a "super bushy" MRNet tree by launching one MRNet tvdsvr process per target MPI process, instead of the default in which it launches one tvdsvr process per node.

This option addresses the CUDA debug API limitation that allows a debugger process (such as the tvdsvr) to debug at most one target process using a GPU. Set this option to true if you are debugging an MPI job in which more than one CUDA process is running on a node.

A read-only state variable that identifies the native (host) platform on which the TotalView client (GUI or CLI) is running. This variable’s value is the same as the value of TV::platform.

When set to auto, TotalView determines which threads package your program is using. A value of true identifies use of NPTL threads, while false means that the program is not using this package.

Contains the string that the CLI executes after you open the CLI by selecting the Tools > Command Line command. It is ignored when you open the CLI from the command line.

This variable is most commonly used to set the terminal characteristics of the (pseudo) tty that the CLI is using, since these are inherited from the tty on which TotalView was started. Therefore, if you start TotalView from a shell running inside an Emacs buffer, the CLI uses the raw terminal modes that Emacs is using. You can change your terminal mode by adding the following command to your .tvdrc file:

When true, TotalView enables runtime support for OpenMP OMPD.

This variable can also be set in a TotalView .tvdrc file within your .totalview directory.

When true, enables TotalView support for parallel program runtime libraries such as MPI, PE, and UPC. You might set this to false if you need to debug a parallel program as if it were a single-process program.

Automatically attaches to processes. Your choices are:

Tells TotalView if it should automatically run processes when your program launches them. Your choices are:

Indicates the platform on which you are running TotalView. This is a read-only variable.

Names the procedures that TotalView runs after it loads or attaches to a program and just before it runs the program. TotalView executes these procedures after it invokes the procedures in the TV::image_load_­callbacks list.

The procedures in this list are called at most once per process load or attach, even though your executable may use many shared libraries. After attaching to the processes in a parallel job, the callback procedures listed in TV::process_load_callbacks are invoked on one representative process in each share group, and only when the share group is first created. If the parallel job is restarted, the callback procedures are not invoked because the share groups are not recreated. All processes in a parallel job are attached before calling the procedures. The calls to the procedures are queued and executed at a later time, and are not guaranteed to be during the lifetime of the processes.

Defines the launch string used when launching a proxy server. For information on this string, see Replacement Characters.

Determines whether a data window displaying the subroutines associated with a source file initially displays just the subroutine names, or also the data values in the subroutine scopes. This situation most commonly occurs in the Program Browser.

Controls how ReplayEngine handles the history buffer when it is full, as follows:

Specifies the size of ReplayEngine’s buffer for recorded history, in either bytes, kilobytes (K) or megabytes (M). To specify kilobytes or megabytes, append a K or M to the number, as follows: 10000K or 1024M

When killing a multi-threaded or multiprocess program, specifies the number of threads or processes that must be running before a prompt launches confirming that you wish to kill the program. By default, this prompt appears if there is more than one thread or process running.

Controls whether TotalView listens for reverse connection requests.

Obsolete.

Obsolete.

Names the file to which TotalView writes or pipes the contents of the current window or pane when you select the File > Save Pane command.

When true, text searches are case-sensitive, succeeding only for an exact match for the entry in the Edit > Find dialog box. For example, searching Foo won’t find foo if this variable is set to true. It will be found if this variable is set to false.

When true, TotalView uses its single-process server launch procedure when launching remote tvdsvr processes. When false, tvdsvr is not automatically launched.

Names the command string that TotalView uses to automatically launch the TotalView Debugger Server (tvdsvr) when debugging a remote process. This command string is executed by /bin/sh. By default, TotalView uses the command ssh -x to start the server, but you can use any other command that can invoke tvdsvr on a remote host. If no command is available for invoking a remote process, you can’t automatically launch the server; therefore, you should set this variable to /bin/false. If you cannot automatically launch a server, you should also set the TV::server_launch_enabled variable to false. For information on this launch string, see Replacement Characters.

Specifies the number of seconds to wait for a response from the TotalView Debugger Server (tvdsvr) that it has launched.

Specifies how long to wait for a response from the TotalView Debugger Server (tvdsvr). Using a higher value may help avoid server timeouts if you are debugging across multiple nodes that are heavily loaded.

Indicates the scope in which TotalView places newly created action points. In the CLI, this is the dbarrier, dbreak, and dwatch commands. If true, newly created action points are shared across the group. If false, a newly created action point is active only in the process in which it is set.

As an alternative to setting this variable, you can select the Plant in share group check box in the Action Points Page in the File > Preferences dialog box. You can override this value in the GUI by selecting the Plant in share group checkbox in the Action Point > Properties dialog box.

A list that modifies the way in which TotalView handles signals. This list consists of a list of signal_action descriptions, separated by spaces:

A signal_list is a list of one or more signal specifiers, separated by commas:

The following rules apply when you are specifying an action_list:

For example, to set the default action for the SIGTERM signal to Resend, you specify the following action list:

Sets the width of the tab character that is displayed in the Process Window’s Source Pane. You may want to set this value to the same value as you use in your text editor.

When you use the View > Lookup Function or View > Lookup Variable commands in the Process Window or edit a type string in a Variable Window, TotalView checks the spelling of your entries. By default (verbose), TotalView displays a dialog box before it corrects spelling. You can set this resource to brief to run the spelling corrector silently. (TotalView 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.

Controls the behavior of reading delayed symbols while building a stack backtrace in order to find inlined subroutines. By default, this variable is set to auto, so that TotalView attempts to automatically detect whether the subroutine associated with a stack frame might contain inlined subroutines; if so, it reads the delayed symbols for the file containing the subroutine.

If you are sure your subroutines contain no inlined subroutines or you are experiencing debugging performance issues during stack backtraces, you can set this value to false. However, doing so might result in stack backtraces that are missing inlined subroutines.

A setting of true means that TotalView will always attempt to read delayed symbols for inlined subroutines, but this could result in poorer debugger performance when building a stack backtrace. However, doing so will ensure that stack backtraces always contain all inlined subroutines.

Controls the amount of information displayed in stack traces. For more information, see TV::dwhere_qualification_level.

Controls whether TotalView filters the stack. Because not all applications can benefit from stack filtering, this variable is false by default.

Indicates a default property for newly created action points. This property tells TotalView what else it should stop when it encounters this action point. The values you can set are:

When true, TotalView stops the control group when an error signal is raised. This is the variable used by the Stop control group on error signal option in the Options Page of the File > Preferences dialog box.

Use a space separated list of items to identify the contents of a file. Each item on this list has the form: suffix:lang[:include]. You can set more than suffix for an item. If you want to remove an item from the default list, set its value to unknown.

A read-only variable that displays a list of the platforms on which you can debug from the native (host) platform, usually in the format os-cpu. For example, from a native platform of Linux-x86-64, the list is “linux-x86_64.” The platform names may be listed differently than in TV::platform and TV::native_platform. For example, for AIX, TV::target_platform is “aix-power” but TV::platform and TV::native_platform are “rs6000.”

When true, TotalView uses registered type transformations to change the appearance of data types that have been registered using the TV::type_transformation command.

When transforming STL structures, TotalView must chase through pointers to obtain values. This number indicates how many of these pointers it should follow.

Controls TotalView’s use of the target operating system’s support of the fast trap mechanism for compiled conditional breakpoints, also known as EVAL points. You cannot interactively use this variable. Instead, you must set it within a TotalView startup file; for example, set its value with a .tvdrc file.

Your operating system may not be configured correctly to support this option. See the Classic TotalView Release Notes on our web site for more information.

Controls TotalView’s use of the target operating system’s support of the fast trap mechanism for compiled conditional watchpoints, also known as CDWP points. You cannot interactively use this variable. Instead, you must set it within a TotalView startup file; for example, set its value with a .tvdrc file.

Your operating system may not be configured correctly to support this option. See the Classic TotalView Release Notes on our web site for more information.

This variable is a synonym for TV::local_interface.

When true, it enables TotalView support for handling user-level (M:N) thread packages on systems that support two-level (kernel and user) thread scheduling.

Indicates the current TotalView version. This is a read-only variable.

When true, TotalView automatically launches the Visualizer when you first visualize something. If you set this variable to false, TotalView disables visualization. This is most often used to stop evaluation points containing a $visualize directive from invoking the Visualizer.

Specifies the command string that TotalView uses when it launches a visualizer. Because the text is actually used as a shell command, you can use a shell redirection command to write visualization datasets to a file (for example, “cat > your_file”).

Specifies the default value used in the Maximum permissible rank field in the Launch Strings Page of the File > Preferences dialog box. This field sets the maximum rank of the array that TotalView will export to a visualizer. The Visualizer cannot vis­ualize arrays of rank greater than 2. If you are using another visualizer or just dumping binary data, you can set this value to a larger number.

If this is set to true and your program throws an exception during a single-step operation, TotalView asks if you wish to stop the step operation. The process will be left stopped at the C++ run-time library’s “throw” routine. If this is set to false, TotalView will not catch C++ exception throws during single-step operations. Setting it to false may mean that TotalView will lose control of the process, and you may not be able to control the program.

When true, TotalViewwill continue searching from either the beginning (if Down is also selected in the Edit > Find dialog box) or the end (if Up is also selected) if it doesn’t find what you’re looking for. For example, you search for foo and select the Down button. If TotalView doesn’t find it in the text between the current position and the end of the file, TotalView will continue searching from the beginning of the file if you set this option.

A command that needs to be executed before executing a process on a remote host, e.g., runauth. This string is passed to MRNet instead of using the XPLAT_REMCMD environment variable. This value is only used when TotalView uses MRNet.

An rsh command that is passed to MRNet instead of using the XPLAT_RSH environment variable. This command is used to launch remote processes. If this variable isn't explicitly set and the XPLAT_RSH environment variable is empty, TotalView uses the value of TV::launch_command. This value is used only when TotalView uses MRNet.

A list of arguments that need to be given to the remote launch command. This string is passed to MRNet instead of using the XPLAT_RSH_ARGS environment variable. This value is only used when TotalView uses MRNet.

The name of the program that TotalView should use when spawning the CLI. In most cases, you will set this using the -xterm_name command-line option.