Totalview® Reference Guide : PART I CLI Commands : Chapter 5 TotalView Variables : TV:: Namespace
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_cell_spu_image_load
If true, TotalView might ask whether to stop the process when a Cell SPU image is loaded. If false, TotalView does not stop execution when a Cell SPU image is loaded.
Permitted Values: true or false
Default: true
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: true
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.
Permitted Values: An array specification
Default: [10]
TV::auto_array_­cast_enabled
When true, TotalView automatically 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 undereference 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
Tells TotalView if and how it should 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 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_­nested_c
Tells TotalView if and how it should 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 undeferenced 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 undeferenced 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, TotalView automatically loads action points from the file named filename.TVD.v3breakpoints where filename is the name of the file being debugged. If false, breakpoints are not automatically loaded. If you set this to false, you can still load breakpoints using the Action Point > Load All or 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.v3breakpoints, where filename is the name of the file being debugged. Information about watchpoints is not saved.
TotalView writes this information when you exit from TotalView. If you set this variable to false, you can explicitly save this information by using the Action Point > Save All or 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::bluegene_io_interface
If the Bluegene front-end cannot resolve the network name, you must initialize this variable (or set it as a command-line option). By default, TotalView assumes that it can resolve the address as follows:
front_end_hostname-io
For example, if the front-end hostname is fred, TotalView assumes that the servers are connecting to fred-io.
Permitted Values: A string
Default: none
Default:  
TV::bluegene_server_launch_­string
Defines the launch string used when launching tvdsvr processes on I/O nodes.
Permitted Values: A string
Default: -callback %L -set_pw %P -verbosity %V %F
TV::bluegene__launch_timeout
Specifies the number of seconds to wait to hear back from the TotalView Debugger Server (tvdsvr) after its launch.
Permitted Values: An integer from 1 to 3600 (1 hour)
Default: 240
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_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".
Permitted Values: A string, usually contained within braces {}
Default: 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".
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. For information on this launch string, see "Replacement Characters".
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. For information on this launch string, see "Replacement Characters".
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. For information on this launch string, see "Replacement Characters".
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.For information on this launch string, see "Replacement Characters".
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. For information on this launch string, see "Replacement Characters".
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::cell_spu_image_ignore_regexp
If set to a non-empty string, and TV::ask_on_cell_spu_image_load is true, TotalView matches the SPU image’s name with the regular expression. For a match, TotalView does not ask to stop the process but allows the process to continue running after loading the SPU image.
If the image name does not match this regular expression or the regular expression contained within TV::cell_spu_images_stop_regexp, TotalView asks if it should stop the process, unless you’ve answered the stop to set breakpoint question by pressing No (or the equivalent from within the CLI).
Permitted Values: A regular expression
Default: {}
TV::cell_spu_images_stop_regexp
If set to a non-empty string and TV::ask_on_cell_spu_image_load is true, TotalView matches the SPU image’s name with the regular expression. For a match, TotalView asks whether to stop the process.
If the image name does not match this regular expression or the regular expression contained within TV::cell_spu_images_ignore_regexp, TotalView asks if it should stop the process, unless you’ve answered the stop to set breakpoint question by pressing No (or the equivalent from within the CLI).
Permitted Values: A regular expression
Default: {}
TV::cell_spurs_jm_name
A string that names the file containing the symbols for the “jm” SPURS job policy module. When TotalView detects an embedded SPURS kernel image being loaded into an SPU context, it extracts the GUIDs of the policy modules from the kernel, and searches for either the default SPU ELF image file, which is spurs_jm.elf or the file named by this variable.
Permitted Values: An ELF file name
Default: spurs_jm.elf
TV::cell_spurs_kernel_dll_regexp
Defines a regular expression that matches the image path component name of the SPURS kernel SPU ELF image embedded in the libspurs.so DLL.
When TotalView sees a new image loaded into an SPU thread by libspe or libspe2, it checks if the image path component name matches this variable. If so, TotalView handles the SPURS kernel library in a different way. You may need to change this regular expression to match the name of your SPURS kernel if it is embedded in a shared library other than libspurs.so or if the name of the SPURS kernel is different than spurs_kernel.elf.
Permitted Values: A regular expression
Default: {/libspurs\.so\(spurs_kernel\.elf@[0-9]+\)$}
TV::cell_spurs_ss_name
A string that names the file containing the symbols for the “ss” SPURS system service policy module. When TotalView detects an embedded SPURS kernel image being loaded into an SPU context, it extracts the GUIDs of the policy modules from the kernel, and searches for either the default SPU ELF image file, which is spurs_tss.elf or the file named by this variable.
Permitted Values: An ELF file name
Default: spurs_ss.elf
TV::cell_spurs_tm_name
A string that names the file containing the symbols for the “tm” SPURS task policy module. When TotalView detects an embedded SPURS kernel image being loaded into an SPU context, it extracts the GUIDs of the policy modules from the kernel, and searches for either the default SPU ELF image file, which is spurs_tm.elf or the file named by this variable.
Permitted Values: An ELF file name
Default: spurs_tm.elf
TV::checksum_­libraries
Permitted Values:  
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 TotalView Users 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 TotalView Users 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 GUI. 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, TotalView enables 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
(HP and 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.
Some Fortran compilers (HP f90/f77, SGI 7.2 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, TotalView kills 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::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.
Permitted Values: A string indicating a path
Default: /var/spool/alps/%A/toolhelper%A
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:
compaq: HP cxx on running Linux-Alpha
gnu: GNU C++ on Linux Alpha
gnu_dot: GNU C++ Linux x86
gnu_v3: GNU C++ Linux x86
hp: HP aCC compiler
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:
xlf90: IBM Fortran
fujitsu_f9x: Fujitsu Fortran 9x
hpux11_64_f9x: HP Fortran 9x
intel: Intel Fortran 9x
sunpro_f9x_4: Sun ProFortran 4
sunpro_f9x_5: Sun ProFortran 5
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 the fork(), 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_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: Sun SPARC: rshAll other platforms: 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 TotalView loads 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 false, enables dlopen event filtering (see "dlopen Options for Scalability").
TV::dlopen_always_recalculate is true by default, meaning that breakpoint specifications are reevaluated on every dlopen call. This is referred to as Slow Mode.
A value of false enables dlopen event filtering, deferring the reevaluation of breakpoint specifications until after the dlopen event and thus reducing the number of events per process that TotalView evaluates. This is useful in improving performance when a process loads large numbers of libraries. Depending on the setting of TV::dlopen_recalculate_on_match, performance can be improved with the Medium or Fast modes of dlopen event filtering.
Permitted Values: true or false
Default: true
TV::dlopen_recalculate_on_match
Contains a colon-separated list of simple glob patterns (a glob list) containing library names. If TV::dlopen_always_recalculate is set to true, the value of this variable is ignored.
glob patterns specify sets of filenames with wildcard characters. A simple glob pattern is a string, optionally ending with an asterisk character (*).
If TV::dlopen_always_recalculate is false and a dlopen event occurs, the name of the library associated with the event is matched against the list of glob patterns. If the glob-list is empty (default) or the name of the dlopened library does not match any patterns in the glob-list, then breakpoint reevaluation is deferred until the process stops for some other reason (e.g., the process hits a breakpoint, the user stops the process, the process encounters a signal, etc.). If the library name matches a pattern, the breakpoints are reevaluated immediately. A glob-list that contains the empty string results in Fast mode, since all the dlopened libraries will have their breakpoint reevaluation deferred. Medium mode is when select libraries are to have their breakpoints reevaluated immediately.
The matching rules are:
If the simple glob pattern does not end in an asterisk, then the tail of the loaded library name must match the string. For example, the string "libfoo.so" matches library name "/dir/path/libfoo.so", but does not match "/dir/path/libfoo.so.1.0".
If the simple glob pattern ends in an asterisk, then the asterisk is removed from the string, and the remaining portion of the string matches any substring found in the library name. For example, the string "libfoo.so*" matches "/dir/path/libfoo.so" or "/dir/path/libfoo.so.1.0", and the string "/path/*" matches "/dir/path/libfoo.so" or "/dir/path/libbar.so".
For a more 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” in the TotalView User Guide.
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::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, TotalView loads symbols from shared libraries. This variable is available on all platforms supported by Rogue Wave 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::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::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 .gnu_debuglink section within your process. If it is found, it looks for the file named in this section. If false, TotalView ignores the contents of this section. This means that a gnu_debuglink file will not be loaded. For more information, see "Using gnu_debuglink Files".
Permitted Values: true or false
Default: true
TV::gnu_debuglink_checksum
When true, TotalView compares the checksum of the gnu_debuglink file against the checksum contained within the .gnu_debuglink section. TotalView will only load the information from the gnu_debuglink file when the checksums match. For more information, see "Using gnu_debuglink Files".
Permitted Values: true or false
Default: true
TV::gnu_debuglink_global_directory
Names the directory to store gnu_debuglink files. For more information, see "Using gnu_debuglink Files".
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_global_search_path
Defines the search path to use when searching for .gnu_debuglink files. You can use two substituting variables when assigning values:
%D: The directory containing the .gnu_debuglink file.
%G: The contents of the TV::gnu_debuglink_global_directory variable.
%/: The target directory delimiter; for example “/”.
For more information, see "Using gnu_debuglink Files".
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::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 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. For information on this launch string, see "Replacement Characters".
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_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::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::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_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 Rogue Wave. You can also define this variable in a tvdrc file contained within your .totalview directory.
For more information, see Appendix A, "MPI Startup".
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 alpha or 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::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.
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::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 (rsh on Sun SPARC), 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".
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_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, the list is “linux-power linux-x86_64 linux-x86 catamount-x86_64 catamount-x86.” 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. As of TotalView 8.7, when this variable was introduced, only AIX supported the fast trap mechanism for breakpoints, but we anticipate other operating systems adding support. 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. As of TotalView 8.7, when this variable was introduced, only AIX supported the fast trap mechanism for watchpoints, but we anticipate other operating systems adding support. 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, TotalView will 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 only used when 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