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.
Permitted Values: true or false
Default: false
TV::auto_array_­cast_bounds
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.
Permitted Values:  An array specification
Default: [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.
Permitted Values: true or false
Default: 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.
Permitted Values: no, yes, or yes_dont_push
Default: 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.
Permitted Values: no, yes, or yes_dont_push
Default: 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.
Permitted Values: no,yes, or yes_dont_push
Default: 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.
Permitted Values: no, yes, or yes_dont_push
Default: 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.
Permitted Values: no, yes, or yes_dont_push
Default: 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.
Permitted Values: no, yes, or yes_dont_push
Default: yes_dont_push
TV::auto_load_breakpoints
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 dactions -load command.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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 dactions-save command.
Permitted Values: true or false
Default: 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.
Permitted Values: group, process, or thread
Default: 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.
Permitted Values: group, process, or thread
Default: group
Default:  
TV::bulk_launch_base_timeout
Defines the base timeout period used to execute a bulk launch.
Permitted Values:  A number from 1 to 3600 (1 hour)
Default: 20
TV::bulk_launch_enabled
If true, uses bulk launch features when automatically launching the TotalView Debugger Server (tvdsvr) for remote processes.
Permitted Values: true or false
Default: false
TV::bulk_launch_incr_timeout
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.
Permitted Values:  A number from 1 to 3600 (1 hour)
Default: 10
TV::bulk_launch_tmpfile1_header_line
Defines the header line used in the first temporary file for a bulk server launch operation.
Permitted Values:  A string
Default: None
TV::bulk_launch_tmpfile1_host_lines
Defines the host line used in the first temporary file when performing a bulk server launch operation.
Permitted Values:  A string
Default: %R
TV::bulk_launch_tmpfile1_trailer_line
Defines the trailer line used in the first temporary file when performing a bulk server launch operation.
Permitted Values:  A string
Default: None
TV::bulk_launch_tmpfile2_header_line
Defines the header line used in the second temporary file when performing a bulk server launch operation.
Permitted Values:  A string
Default: None
TV::bulk_launch_tmpfile2_host_lines
Defines the host line used in the second temporary file when performing a bulk server launch operation.
Permitted Values:  A string
Default: {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.
Permitted Values:  A string
Default: None
TV::c_type_strings
If true, uses C type string extensions to display character arrays; when false, uses string type extensions.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values: auto, true or false
Default: auto
TV::comline_patch_area_base
Allocates the patch space dynamically at the given address. See “Allocating Patch Space for Compiled Expressions” in the Classic TotalView User Guide.
Permitted Values:  A hexadecimal value indicating space accessible to TotalView
Default: 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” in the Classic TotalView User Guide.
Permitted Values:  A positive number
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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 C++View.
Permitted Values: true or false
Default: true
TV::cuda_debugger
Indicates whether cuda debugging is currently enabled. This is a read-only variable.
Permitted Values: true or false
Default: 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++
*spro: SunPro C++ 4.0 or 5.2
*spro5: SunPro C++ 5.0 or later
*sun: Sun CFRONT C++
*xlc: IBM XLC/VAC++ compilers
Permitted Values:  A string naming the compiler
Default: 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:
*intel: Intel Fortran 9x
Permitted Values:  A string naming the compiler
Default: Derived from your platform and information within your program
TV::data_format_double
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}
presentation
Selects which format to use when displaying -information. Note that you can display floating point information using dec, hex, and oct formats. You can display integers using auto, dec, and sci formats.
auto
Equivalent to the C language’s printf() function’s %g specifier. You can use this with integer and floating-point numbers. This format is either hexdec or dechex, depending upon the programming language being used.
dec
Equivalent to the printf() function’s %d specifier. You can use this with integer and floating-point numbers.
dechex
Displays information using the dec and hex formats. You can use this with integers.
hex
Equivalent to the printf() function’s %x specifier. You can use this with integer and floating-point numbers.
hexdec
Displays information using the hex and dec formats. You can use this with integer numbers.
oct
Equivalent to the printf() function’s %o specifier. You can use this with integer and floating-point numbers.
sci
Equivalent to the printf() function’s %e specifier. You can use this with floating-point numbers.
format
For integers, format-1 defines the decimal format, format-2 defines the hexadecimal format, and format-3 defines the octal format.
For floating point numbers, format-1 defines the fixed point display format, format-2 defines the scientific format, and format-3 defines the auto (printf()’s %g) format.
The format string is a combination of the following specifiers:
%
A signal indicating the beginning of a format.
width
A positive integer. This is the same width specifier used in the printf() function.
.(period)
A punctuation mark separating the width from the precision.
precision
A positive integer. This is the same precision specifier used in the printf() function.
# (pound)
Displays a 0x prefix for hexadecimal and 0 for octal formats. This isn’t used within floating-point formats.
0 (zero)
Pads a value with zeros. This is ignored if the number is left-justified. If you omit this character, TotalView pads the value with spaces.
- (hyphen)
Left-justifies the value within the field’s width.
Permitted Values:  A value in the described format
Default: {auto %-1.15 %-1.15 %-20.2}
TV::data_format_ext
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.
Permitted Values:  A value in the described format
Default: {auto %-1.15 %-1.15 %-1.15}
TV::data_format_int8
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.
Permitted Values:  A value in the described format
Default: {auto %1.1 %#4.2 %#4.3}
TV::data_format_int16
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.
Permitted Values:  A value in the described format
Default: {auto %1.1 %#6.4 %#7.6}
TV::data_format_int32
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.
Permitted Values:  A value in the described format
Default: {auto %1.1 %#10.8 %#12.11}
TV::data_format_int64
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.
Permitted Values:  A value in the described format
Default: {auto %1.1 %#18.16 %#23.22}
TV::data_format_int128
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.
Permitted Values:  A value of the described format.
Default: {auto %1.1 %#34.32 %#44.43}
TV::data_format_long_stringlen
Defines the number of characters allowed in a long string.
Permitted Values:  A positive integer number
Default: 8000
TV::data_format_­single
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.
Permitted Values:  A value in the described format
Default: {auto %-1.6 %-1.6 %-1.6}
TV::data_format_stringlen
Defines the maximum number of characters displayed for a string.
Permitted Values:  A positive integer number
Default: 100
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.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: false
TV::default_launch_command
Names the compiled-in launch command appropriate for the platform.
Permitted Values:  A string indicating the default compiled-in launch command value.
Default: 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.
Permitted Values:  A string indicating the default subset specification.
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A string indicating a pathname
Default: None
TV::default_stderr_is_stdout
When true, TotalView writes the target program’s stderr information to the same location as stdout.
Permitted Values: true or false
Default: false
TV::default_stdin_filename
Names the file from which the target program reads stdin information.
Permitted Values:  A string indicating a pathname
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A string indicating a pathname
Default: None
TV::display_assembler_­symbolically
When true, TotalView displays assembler locations as label+offset. When false, these locations are displayed as hexadecimal addresses.
Permitted Values: true or false
Default: 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.
Permitted Values:  A list of path names, each item of which is separated from another by a colon
Default: /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.
Permitted Values:  One or more library names separated by colons
Default: 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.
Permitted Values:  One or more library names separated by colons
Default: 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.
Permitted Values:  One or more library names separated by colons
Default: 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.
Permitted Values:  A Tcl list of suffixes
Default: 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.
Permitted Values: true or false
Default: 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, please refer to dlopen Options for Scalability.
Permitted Values: String
Default: "", 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”.
Permitted Values: true or false
Default: 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
Permitted Values: true or false
Default: 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
Permitted Values: true or false
Default: 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.
Permitted Values:  One or more of the arguments listed above.
Default: 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.
Permitted Values: true or false
Default: 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
Permitted Values:  Any string value—as this is a Tcl variable, you’ll need to enclose the string within {} (braces) if the string contains spaces
Default: {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.
Permitted Values:  None. The variable is read-only.
Default: 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” in the TotalView User Guide.
*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:
Action
Description
halt
Stop the process
go
Continue the process
ask
Ask whether to stop the process
Permitted Values: exec-handling-list
Default: 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.
NOTE: Linux threads are not affected by this variable. This variable should be left set at 3 unless you have reason to believe it is malfunctioning on your system.
Permitted Values:  0, 1, 2, or 3
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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” in the TotalView User Guide.
*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:
Action
Description
attach
Attach to the new child processes.
detach
Detach from the new child processes.
Permitted Values: fork-handling-list
Default: 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
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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” in the TotalView User Guide.
Permitted Values: true or false
Default: 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.
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.
Permitted Values:  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 the appendix section “Using gnu_debuglink Files” in the TotalView User Guide.) 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.
Permitted Values: true or false
Default: Both settings default to true.
 
Table 6: Validating separate debug files
TV::gnu_debuglink_check_build_id
TV::gnu_debuglink_checksum
Result
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.
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.
False
True
Compare checksums only; never compare build IDs. This option may be useful if the build IDs are considered unreliable.
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 appendix section “Using gnu_debuglink Files” in the TotalView User Guide.
Permitted Values:  A pathname within your file system. While this path can be relative, it is usually a full pathname.
Default: /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.
Permitted Values:  A string containing directory paths.
Default: %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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A Tcl list of procedure names
Default: {::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.
Permitted Values: true or false
Default: false
TV::ipv6_support
When true, ipv6 support is enabled. If false, ipv6 support is disabled.
Permitted Values: true or false
Default: 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.
NOTE: Support for JIT debugging is limited to CLANG LLVM on Linux-x86_64.
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
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values:  List of one or more list of pairs
Default: {}
TV::library_cache_directory
Specifies the directory to write library cache data.
Permitted Values:  A string indicating a path
Default: $USERNAME/.totalview/lib_cache
TV::launch_command
Specifies the launch command.
Permitted Values:  A string indicating the launch command
Default: 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.)
Permitted Values:  A string
Default: {}
TV::local_server
(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.
Permitted Values:  A file or path name to the local server
Default: tvdsvr
TV::local_server_launch_string
(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.
Permitted Values:  A string enclosed with {} (braces) if it has embedded spaces
Default: {%M -working_directory %D -local %U -set_pw %P -verbosity %V}
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.
Permitted Values: true or false
Default: true
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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A port number
Default: {}
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.
Permitted Values: auto, true or false
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A string indicating a platform
Default: 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.
Permitted Values: true, false, or auto
Default: 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"
Permitted Values: A string representing a Tcl or CLI command
Default: 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.
Permitted Values: true or false
Default: false
TV::openmp_ompd_filter_stack
OpenMP-specific variable to control whether TotalView filters the stack. This option allows a different setting for OpenMP programs as compared to other programs. When auto, this variable is set to the same value as TV::stack_trace_transform_enabled. If either true or false, its value is not affected by TV::stack_trace_transform_enabled.
Set this option to true to always enable stack filtering in an OpenMP program. A value of false disables stack filtering for OpenMP programs. Neither value impacts the value of TV::stack_trace_transform_enabled.
This variable can also be set in a TotalView .tvdrc file within your .totalview directory.
Permitted Values: auto, true, or false
Default: auto
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.
Permitted Values: true or false
Default: 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.
Permitted Values: yes, no, or ask
Default: yes
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.
Permitted Values: yes, no, or ask
Default: ask
TV::platform
Indicates the platform on which you are running TotalView. This is a read-only variable.
Permitted Values:  A string indicating a platform, such as sun5
Default: Platform-specific
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.
Permitted Values:  A list of Tcl procedures
Default: 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.
Permitted Values:  A string
Default: %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.
Permitted Values: true or false
Default: 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.
Permitted Values:  1 or 2
Default: 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
Permitted Values:  An integer or an integer followed by K or M
Default: 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.
Permitted Values:  A positive integer
Default: 1
TV::reverse_connect_wanted
Controls whether TotalView listens for reverse connection requests.
Permitted Values: true or false
Default: 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.
Permitted Values:  A string naming a file or pipe
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A string
Default: {%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.
Permitted Values: An integer from 1 to 3600 (1 hour)
Default: 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.
Permitted Values:  An integer from 1 to 3600 (1 hour)
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A list of signals, as was just described
Default: 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.
Permitted Values:  An integer
Default: 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.
Permitted Values: verbose, brief, or none
Default: verbose
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.
Permitted Values: true, false, or auto
Default: auto
TV::stack_trace_qualification_level
Controls the amount of information displayed in stack traces. For more information, see TV::dwhere_qualification_level.
Permitted Values:  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.
Default: class_name+template_args+module+ parent_function+member+node
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.
Permitted Values: group, process, or thread
Default: group
TV::stop_relatives_on_proc_error
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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A list identifying how suffixes are used
Default: {: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.”
Permitted Values:  A list of platform names
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values:  An integer number
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: true
TV::version
Indicates the current TotalView version. This is a read-only variable.
Permitted Values:  A string
Default: 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.
Permitted Values: true or false
Default: 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”).
Permitted Values:  A string
Default: %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.
Permitted Values:  An integer
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values: true or false
Default: 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.
Permitted Values:  A command
Default: {}
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 Classic TotalView uses MRNet.
Permitted Values:  A remote launch command
Default: {}
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.
Permitted Values:  A space-separated list of remote launch arguments
Default: {}
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.
Permitted Values:  A string
Default: xterm