TV::Namespace

TV::aix_use_fast_ccw

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.

TV::aix_use_fast_trap

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.

TV::ask_on_dlopen

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.

true or false

false

TV::auto_array_cast_bounds

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

An array specification

[10]

TV::auto_array_cast_enabled

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.

true or false

false

TV::auto_deref_in_all_c

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

yes_dont_push

While automatic dereferencing will occur, does not allow use of the Undive command to see the undereferenced value when performing a Dive in All operation.

yes

Allows use of the Undive control to see undereferenced values.

no

Does not automatically dereference values when performing a Dive in All operation.

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

no, yes, or yes_dont_push

no

TV::auto_deref_in_all_fortran

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

yes_dont_push

While automatic dereferencing will occur, does not allow use of the Undive command to see the undereferenced value when performing a Dive in All operation.

yes

Allows use of the Undive control to see undereferenced values.

no

Does not automatically dereference values when performing a Dive in All operation.

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

no, yes, or yes_dont_push

no

TV::auto_deref_initial_c

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

yes_dont_push

While automatic dereferencing will occur, does not allow use of the Undive command to see the undereferenced value.

yes

Allows use of the Undive control to see undeferenced values.

no

Does not automatically dereference values.

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

no, yes, or yes_dont_push

no

TV::auto_deref_initial_fortran

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

yes_dont_push

While automatic dereferencing will occur, does not allow use of the Undive command to see the undereferenced value.

yes

Allows use of the Undive control to see undereferenced values.

no

Does not automatically dereference values.

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

no, yes, or yes_dont_push

no

TV::auto_deref_nested_c

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

yes_dont_push

While automatic dereferencing will occur, you can’t use the Undive command to see the undereferenced value.

yes

You will be able to use the Undive control to see undereferenced values.

no

Do not automatically dereference values.

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

no, yes, or yes_dont_push

yes_dont_push

TV::auto_deref_nested_fortran

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

yes_dont_push

While automatic dereferencing will occur, does not allow use of the Undive command to see the undereferenced value.

yes

Allows use of the Undive control to see undereferenced values.

no

Does not automatically dereference values.

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

no, yes, or yes_dont_push

yes_dont_push

TV::auto_load_breakpoints

If true, TotalView automatically 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 Points > Load menu option or the dactions -load command.

true or false

true

TV::auto_read_symbols_at_stop

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.

true or false

true

TV::auto_save_breakpoints

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 Points > Save or the dactions -save command.

true or false

false

TV::barrier_stop_all

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:

group

Stops all processes in a thread’s control group when a thread reaches a barrier created using this as a default.

process

Stops the process in which the thread is running when a thread reaches a barrier created using this default.

thread

Stops only the thread that hit a barrier created using this default.

This variable is the same as the BARRIER_STOP_ALL variable.

group, process, or thread

group

TV::barrier_stop_when_done

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:

group

When a barrier is satisfied, stops all processes in the control group.

process

When a barrier is satisfied, stops the processes in the satisfaction set.

thread

Stops only the threads in the satisfaction set; other threads are not affected. For process barriers, there is no difference between process and none.

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.

group, process, or thread

group

TV::bulk_launch_base_timeout

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

A number from 1 to 3600 (1 hour)

20

TV::bulk_launch_enabled

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

true or false

false

TV::bulk_launch_incr_timeout

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

A number from 1 to 3600 (1 hour)

10

TV::bulk_launch_string

Defines the command used to launch the TotalView Debugger Server (tvdsvr) when remote processes are created. For information on this launch string, see Replacement Characters.

A string, usually contained within braces {}

The default value depends upon the platform; use the dset command to see the default.

TV::bulk_launch_tmpfile1_header_line

Defines the header line used in the first temporary file for a bulk server launch operation. For information on this launch string, see Replacement Characters.

A string

None

TV::bulk_launch_tmpfile1_host_lines

Defines the host line used in the first temporary file when performing a bulk server launch operation. For information on this launch string, see Replacement Characters.

A string

%R

TV::bulk_launch_tmpfile1_trailer_line

Defines the trailer line used in the first temporary file when performing a bulk server launch operation. For information on this launch string, see Replacement Characters.

A string

None

TV::bulk_launch_tmpfile2_header_line

Defines the header line used in the second temporary file when performing a bulk server launch operation. For information on this launch string, see Replacement Characters.

A string

None

TV::bulk_launch_tmpfile2_host_lines

Defines the host line used in the second temporary file when performing a bulk server launch operation. For information on this launch string, see Replacement Characters.

A string

{tvdsvr -working_directory %D -callback %L -set_pw %P -verbosity %V}

TV::bulk_launch_tmpfile2_trailer_line

Defines the trailer line used in the second temporary file when performing a bulk server launch operation. For information on this launch string, see Replacement Characters.

A string

None

TV::c_type_strings

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

true or false

true

TV::check_unique_id

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.

true or false

true

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.

auto, true or false

auto

TV::comline_patch_area_base

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

A hexadecimal value indicating space accessible to TotalView

0xffffffffffffffff

TV::comline_patch_area_length

Sets the length of the dynamically allocated patch space to the specified length. See Allocating Patch Space for Compiled Expressions.

A positive number

0

TV::command_editing

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.

true or false

false

TV::compile_expressions

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 TotalView Release Notes to determine if your version of the operating system supports this feature.

true or false

false

TV::compiler_vars

(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:

-compiler_vars: sets this variable to true

-no_compiler_vars: sets this variable to false

true or false

false

TV::control_c_quick_shutdown

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.

true or false

true

TV::copyright_string

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

TV::cppview

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 Licensing.

true or false

true

TV::cray_xt_mrnet_filterlib_dir

The path to the directory that contains MRNet filter libraries on a Cray compute node. This string is expanded before use. See the section Replacement Characters for more information. This value is only used when TotalView uses MRNet on Cray systems.

A string indicating a path

/var/spool/alps/%A/toolhelper%A

TV::cuda_debugger

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

true or false

true

TV::current_cplus_demangler

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:

• gnu_dot: GNU C++ Linux x86

• gnu_v3: GNU C++ Linux x86

• kai: KAI C++

• kai3_n: KAI C++ version 3.n

• kai_4_0: KAI C++

• xlc: IBM XLC/VAC++ compilers

A string naming the compiler

Derived from your platform and information within your program

TV::current_fortran_demangler

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:

• xlf90: IBM Fortran

• fujitsu_f9x: Fujitsu Fortran 9x

• intel: Intel Fortran 9x

A string naming the compiler

Derived from your platform and information within your program

TV::data_format_{single,double,ext} (floating point formatters)

The following variables define how floating-point values are displayed in TotalView:

TV::data_format_{8,16,32,64,128} (integer formatters)

The following variables define how integer values of various bit widths are displayed in TotalView:

TV::data_format_{stringlen,long_stringlen} (string formatters)

The following variables control how string values are displayed in TotalView:

TV::dbfork

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.

true or false

true

TV::default_breakpoints_pending

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.

true or false

false

TV::default_launch_command

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

A string indicating the default compiled-in launch command value.

ssh -x

TV::default_parallel_attach_subset

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

A string indicating the default subset specification.

Initialized to the value specified with the -default_parallel_attach_subset command line option.

TV::default_stderr_append

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.

true or false

false

TV::default_stderr_filename

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.

A string indicating a pathname

None

TV::default_stderr_is_stdout

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

true or false

false

TV::default_stdin_filename

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

A string indicating a pathname

None

TV::default_stdout_append

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.

true or false

false

TV::default_stdout_filename

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.

A string indicating a pathname

None

TV::display_assembler_symbolically

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

true or false

false

TV::dll_ignore_prefix

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:

• You also set the TV::ask_on_dlopen variable to true.

• The suffix of the library being loaded does not match a suffix contained in the TV::dll_stop_suffix variable.

• One or more of the prefixes in this list match the name of the library being loaded.

A list of path names, each item of which is separated from another by a colon

/lib/:/usr/lib/:/usr/lpp/:/usr/ccs/lib/:/usr/dt/lib/:/tmp/

TV::dll_read_all_symbols

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:

• *: zero or more characters.

• ?: a single character.

Because this is the default behavior, include only library names here that would be excluded because they are selected by a wildcard match within the TV:dll_read_loader_symbols_only and TV::dll_read_no_symbols variables.

One or more library names separated by colons

None

TV::dll_read_loader_symbols_only

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:

• *: zero or more characters.

• ?: a single character.

If you do not need to debug most of your shared libraries, set this variable to * and then put the names of any libraries you wish to debug on the TV::dll_read_all_symbols list.

One or more library names separated by colons

None

TV::dll_read_no_symbols

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:

• *, which means zero or more characters

• ?, which means a single character.

Because information about subroutines, variables, and file names are not known for these libraries, stack backtraces may be truncated. However, if your program uses large shared libraries and it’s time consuming to read even their loader symbols, you may want to put those libraries on this list.

One or more library names separated by colons

None

TV::dll_stop_suffix

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:

• If TV::ask_on_dlopen variable is set to true

• If one or more of the suffixes in this list match the name of the library being loaded.

A Tcl list of suffixes

None

TV::dlopen_always_recalculate

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.

true or false

true

TV::dlopen_recalculate_on_match

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, see dlopen Options for Scalability.

String

"", the empty string

TV::dlopen_read_libraries_in_parallel

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.

true or false

false

TV::dump_core

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:

-dump_core sets this variable to true

-no_dumpcore sets this variable to false

true or false

false

TV::dwarf_global_index

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:

-dwarf_global_index sets this variable to true

-no_dwarf_global_index sets this variable to false

true or false

true

TV::dwhere_qualification_level

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

dset TV::dwhere_qualification_level +overload_list

dset TV::dwhere_qualification_level -class_name

dset TV::dwhere_qualification_level -parent_function

You could combine these arguments into one command. For example:

dset TV::dwhere_qualification_level +overload_list \ -class_name -parent_function

In these examples “+” means that the information should be displayed and “-” means the information should not be displayed.

The arguments to this command are:

• all

• class_name

• file_directory

• hint

• image_directory

• loader_directory

• member

• module

• node

• overload_list

• parent_function

• template_args

• type_name

The all argument is often used as follows:

dset TV::dwhere_qualification_level all-parent_function

This states that all elements are displayed except for a parent function. For more information on these arguments, see symbol.

One or more of the arguments listed above.

class_name+template_args+module+ parent_function+member+node

TV::dynamic

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.

true or false

true

TV::editor_launch_string

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

Any string value—as this is a Tcl variable, you’ll need to enclose the string within {} (braces) if the string contains spaces

{xterm -e %E +%N %S}

TV::env

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.

None. The variable is read-only.

None

TV::exec_handling

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.

• regexp: A regular expression. The regular expression is not anchored, so use "^" and "$" to match the beginning or end of the process name.

• action: The action to take, as follows:

  • halt: Stops the process.

  • go: Continues the process.

  • ask: Asks whether to stop the process.

exec-handling-list

None

TV::follow_clone

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.

0, 1, 2, or 3

3

TV::force_default_cplus_demangler

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.

true or false

false

TV::force_default_f9x_demangler

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.

true or false

false

TV::fork_handling

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.

• regexp: A regular expression. The regular expression is not anchored, so use "^" and "$" to match the beginning or end of the process name.

• action: The action to take, as follows:

  • attach: Attaches to the new child processes.

  • detach: Detaches from the new child processes.

fork-handling-list

None

TV::gdb_index

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:

-gdb_index sets this variable to true

-no_gdb_index sets this variable to false

true or false

true

TV::global_typenames

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.

true or false

true

TV::gnu_debuglink

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 the section Maintaining Debug Information Separate from an Executable.

true or false

true

TV::gnu_debuglink_build_id_search_path

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/current/onlinedocs/gdb.html/Separate-Debug-Files.html

For a build ID such as:

be0e052ddd73fd5f3f15975ac02f4ca903d9bf77

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.

For more information, see the section Using gnu_debuglink Files.

 A colon-separated build ID search path

TV::gnu_debuglink_check_build_id
TV::gnu_debuglink_checksum

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 and the appendix section Using gnu_debuglink Files. 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.

Validating separate debug files details how these settings work together.

true or false

Both settings default to true.

Table 30. Validating separate debug files

Variable	Setting	Result
TV::gnu_debuglink_check_build_id TV::gnu_debuglink_checksum	True True	The default. Compare build IDs if the base image file contains a build ID; otherwise, compare checksums. This option never compares both the build ID and the checksum.
TV::gnu_debuglink_check_build_id TV::gnu_debuglink_checksum	True False	Compare build IDs if the base image file contains a build ID. If the base image file has no build ID, then no comparison occurs, and TotalView uses the separate debug info file. If the base image file has a build ID but there is no match, or the separate debug info file has no build ID, the debug info file is rejected. Choose this option only if you know that the base image files contain a build ID or that the separate debug info files match.
TV::gnu_debuglink_check_build_id TV::gnu_debuglink_checksum	False True	Compare checksums only; never compare build IDs. This option may be useful if the build IDs are considered unreliable.
TV::gnu_debuglink_check_build_id TV::gnu_debuglink_checksum	False False	Compare neither build IDs nor checksums, and unconditionally use the separate debug info files. Choose this option only if you know that the separate debug info files match.

TV::gnu_debuglink_global_directory

Names the global directory containing separate debug files.

For more information, see the following pages:

• Maintaining Debug Information Separate from an Executable

• Using gnu_debuglink Files

 A pathname within your file system. While this path can be relative, it is usually a full pathname.

/usr/lib/debug

TV::gnu_debuglink_search_path

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

• %D: The directory containing the image file. Note that the directory ends in the target directory delimiter, for example "/".

• %G: The contents of the TV::gnu_debuglink_global_directory variable.

• %/: The target directory delimiter; for example “/”.

• %%: A '%' character.

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

For more information, see the following pages:

• Maintaining Debug Information Separate from an Executable

• Using gnu_debuglink Files

 A string containing directory paths.

%D:%D.debug:%G%/%D

TV::hia_local_dir

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.

TV::hia_local_installation_dir

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

TV::hia_remote_dir

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.

TV::hpf

Deprecated.

TV::hpf_node

Deprecated.

TV::host_platform

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

TV::ignore_control_c

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.

true or false

false

TV::image_load_callbacks

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:

• A user invokes a command such as dload.

• TotalView resolves dynamic library dependencies.

• User code uses dlopen() to load a new image.

TotalView invokes the functions in order, beginning at the first function in this list.

A Tcl list of procedure names

{::TV::S2S::handle_image_load}

TV::in_setup

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.

true or false

false

TV::ipv6_support

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

true or false

false

TV::jit_debugging

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:

-jit_debugging sets this variable to true

-no_jit_debugging sets this variable to false

true or false

true

TV::jnibridge

Internal use only.

TV::kcc_classes

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.

true or false

true

TV::kernel_launch_string

This is not currently used.

TV::kill_callbacks

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

dset TV::kill_callbacks {

{^srun$ TV::destroy_srun}

}

The first element in the pair is a regular expression, and the second is the name of a Tcl function. If the process’s name matches the regular expression, TotalView runs the Tcl procedure, giving it the DPID of the process as its argument. This procedure can do anything that needs to be done for orderly process termination.

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.

List of one or more list of pairs

{}

TV::library_cache_directory

Specifies the directory to write library cache data.

A string indicating a path

$USERNAME/.totalview/lib_cache

TV::launch_command

Specifies the launch command.

A string indicating the launch command

The value of TVDSVRLAUNCHCMD, if set; otherwise, the value of TV::default_launch_command. Note: changing the value of TVDSVRLAUNCHCMD in the environment after starting TotalView does not affect this variable or how %C is expanded.

TV::local_interface

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.)

A string

{}

TV::message_queue

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.

true or false

true

TV::mpibind_regexp

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:

mpirun <mpirun-args> mpibind myMPIApp <myMPIApp-args>

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:

dset TV::mpibind_regexp <regexp>

a Tcl regular expression

^(.*/)?mpibind$

TV::mrnet_enabled

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.

true or false

true

TV::mrnet_port_base

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.

A port number

{}

TV::mrnet_proxy_server

Controls the use of an MRNet proxy server.

• auto: Use an MRNet proxy server only if necessary. Default

• true: Use an MRNet proxy server, even if unnecessary. Useful for testing and debugging the proxy server.

• false: Do not use an MRNet proxy server, even if necessary. Likely to cause a fatal error if using a proxy server is necessary.

auto, true or false

auto

TV::mrnet_super_bushy

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.

true or false

false

TV::native_platform

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.

A string indicating a platform

platform-specific

TV::nptl_threads

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.

true, false, or auto

auto

TV::open_cli_window_callback

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:

dset TV::open_cli_window_callback "stty sane"

A string representing a Tcl or CLI command

null

TV::openmp_debug_enabled

When true, TotalView enables runtime support for OpenMP OMPD.

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

true or false

false

TV::parallel

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.

true or false

true

TV::parallel_attach

Automatically attaches to processes. Your choices are:

• 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 to which ones TotalView should attach.

yes, no, or ask

yes

TV::parallel_configs

Defines a new parallel configuration or overwrites an existing one. You can define this variable in a global .tvdrc to add new configurations or overwrite those provided by Perforce. You can also define this variable in a tvdrc file contained within your .totalview directory.

TV::parallel_stop

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

• 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 if it should stop before executing.

yes, no, or ask

ask

TV::platform

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

A string indicating a platform, such as linux-x86-64

Platform-specific

TV::port_base

Specifies the port for tvdsvr callback connections when a TotalView server process is launched on a remote host. The TotalView client creates a listening socket by finding the first available port starting at the value specified by this variable, and the tvdsvr process connects back to the TotalView client process using a TCP/IP socket bound to that port.

This variable can be set by using the following CLI command:

dset TV::port_base <number>

It can also be set by using the -port_base command-line option.

A number between 1 and 65535, inclusive

4142

TV::process_load_callbacks

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.

A list of Tcl procedures

TV::source_process_startup. The default procedure looks for a file with the same name as the newly loaded process’s executable image that has a .tvd suffix appended to it. If it exists, TotalView executes the commands contained within it. This function is passed an argument that is the ID for the newly created process.

TV::proxy_server_server_launch_­string

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

A string

%B/tvdsvr%K -callback %L -set_pw %P -verbosity %V %F %X

TV::recurse_subroutines:

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, available in the Classic UI.

• true: Displays both the subroutine names and the data in their scope.

• false: Displays only the subroutine names.

For complex applications, determining the state of the data values in the scope of all subroutines can significantly slow down TotalView. If set to false so only the subroutine names appear, data values for a particular subroutine can still be viewed by explicitly diving into the subroutine.

true or false

true

TV::replay_history_mode

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

• 1: Discards the oldest history and continue.

• 2: Stops the process.

1 or 2

1

TV::replay_history_size

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

An integer or an integer followed by K or M

0 (Limited only by available memory)

TV::restart_threshold

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.

A positive integer

1

TV::rocm_show_agent_object_thread

Controls whether device address space threads are displayed and their dtids returned.

• true: The debugger displays device address space threads and returns their dtids.

• false: The debugger hides device address space threads and does not return their dtids when possible.

true or false

false

TV::rocm_stable_agent_thread_ids

Controls the dtid value assigned to a device address space thread.

• true: The debugger attempts to assign a device address space thread the same dtid as was assigned to the agent thread, and vice-versa. The dtid values assigned to the device address space and agent threads are from “-1” to “-N”, where “N” is the number of GPUs in use by the process. The wave thread dtids start at “-(N+1)” and count down toward negative infinity.

• false: The debugger assigns device address space threads large negative dtid values that start at “-1073741825” and count down toward negative infinity. The wave thread dtids start at “-1” and count down toward negative infinity.

true or false

true

TV::rocm_wave_threads_mode

Specifies whether wave-thread mode is enabled when a process is first loaded into the debugger.

• true: Wave thread mode is enabled when a process is first loaded into the debugger.

• false: Wave thread mode is not enabled when a process is first loaded into the debugger.

true or false

false

TV::reverse_connect_wanted

Controls whether TotalView listens for reverse connection requests.

true or false

true

TV::save_global_dialog_defaults

Obsolete.

TV::save_search_path

Obsolete.

TV::save_window_pipe_or_filename

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.

A string naming a file or pipe

None, until something is saved. Afterward, the saved string is the default.

TV::search_case_sensitive

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.

true or false

false

TV::server_launch_enabled

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

true or false

true

TV::server_launch_string

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.

A string

{%C %R -n "%B/tvdsvr -working_directory %D -callback %L -set_pw %P -verbosity %V %F"}

TV::server_launch_timeout

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

An integer from 1 to 3600 (1 hour)

30

TV::server_response_wait_timeout

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.

An integer from 1 to 3600 (1 hour)

30

TV::share_action_point

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.

true or false

true

TV::signal_handling_mode

A list that modifies the way in which TotalView handles signals. This 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.

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 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.

1. Sets the action for all signals to Stop.

2. Changes the action for SIGSEGV and SIGBUS from Stop to Error.

3. Changes the action for SIGHUP and SIGTERM from Stop to Resend.

A list of signals, as was just described

This differs from platform to platform; type dset TV::signal_handling_mode to see what a platform’s default values are

TV::source_pane_tab_width

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.

An integer

8

TV::spell_correction

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.

verbose, brief, or none

verbose

TV::split_port_base

Specifies the base port for tvdsvr callback connections when TotalView uses bulk server launch.

This variable can be set by using the following CLI command:

dset TV::split_port_base <number>

It can also be set by using the -split_port_base command-line option.

A number between 1 and 65535, inclusive

16384

TV::stack_trace_expand_inlined_subroutines

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.

true, false, or auto

auto

TV::stack_trace_qualification_level

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

One or more of the following arguments: all, class_name, file_directory, hint, image_directory, loader_directory, member, module, node, overload_list, parent_function, template_args, type_name.

class_name+template_args+module+ parent_function+member+node

TV::stack_trace_transform_enabled

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

true or false

false

TV::stop_all

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:

group

Stops the entire control group when the action point is hit.

process

Stops the entire process when the action point is hit.

thread

Only stops the thread that hit the action point. Note that none is a synonym for thread.

group, process, or thread

group

TV::stop_relatives_on_proc_error

When true, TotalView stops the control group when an error signal is raised.

true or false

true

TV::suffixes

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 list identifying how suffixes are used

{:c:include s:asm S:asm c:c h:c:include lex:c:include y:c:include bmap:c:include f:f77 F:f77 f90:f9x F90:f9x hpf:hpf HPF:hpf cxx:c++ cpp:c++ cc:c++ c++:c++ C:c++ C++:c++ hxx:c++:include hpp:c++:include hh:c++:include h++:c++:include HXX:c++:include HPP:c++:include HH:c++:include H:c++:include ih:c++:include th:c++}

TV::target_platform

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.”

A list of platform names

Platform-dependent

TV ::ttf

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

true or false

true

TV::ttf_max_length

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

An integer number

10000

TV::use_fast_trap

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 TotalView Release Notes on our web site for more information.

true or false

true

TV::use_fast_wp

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 TotalView Release Notes on our web site for more information.

true or false

false

TV::use_interface

This variable is a synonym for TV::local_interface.

TV::user_threads

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.

true or false

true

TV::version

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

A string

Varies from release to release

TV::visualizer_launch_enabled

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.

true or false

true

TV::visualizer_launch_string

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”).

A string

%B/visualize

TV::visualizer_max_rank

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.

An integer

2

TV::warn_step_throw

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.

true or false

true

TV::wrap_on_search

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.

true or false

true

TV::xplat_remcmd

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.

A command

{}

TV::xplat_rsh

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 remote launch command

{}

TV::xplat_rsh_args

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.

A space-separated list of remote launch arguments

{}

TV::xterm_name

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.

A string

xterm