This variable is defined only on AIX, and is a synonym for the platform-independent variable TV::use_fast_wp, providing TotalView script backward compatibility. See TV::use_fast_wp for more information.
This variable is defined only on AIX, and is a synonym for the platform-independent variable TV::use_fast_trap, for TotalView script backward compatibility. See TV::use_fast_trap for more information.
If true, TotalView 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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
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.
Allows use of the Undive control to see undereferenced values.
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:
|
|
Default:
|
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:
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.
Allows use of the Undive control to see undereference values.
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:
|
|
Default:
|
TV::auto_deref_initial_c
While automatic dereferencing will occur, does not allow use of the Undive command to see the undereferenced value.
Allows use of the Undive control to see undeferenced 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:
|
|
Default:
|
TV::auto_deref_initial_fortran
While automatic dereferencing will occur, does not allow use of the Undive command to see the undereferenced value.
Allows use of the Undive control to see undeferenced 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:
|
|
Default:
|
TV::auto_deref_nested_c
While automatic dereferencing will occur, you can’t use the Undive command to see the undereferenced value.
You will be able to use the Undive control to see undeferenced 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:
|
|
Default:
|
While automatic dereferencing will occur, does not allow use of the Undive command to see the undereferenced value.
Allows use of the Undive control to see undeferenced 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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
Contains the value of the “stop_all” property for newly created action points. This property defines what else 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:
Stops all processes in a thread’s control group when a thread reaches a barrier created using this as a default.
Stops the process in which the thread is running when a thread reaches a barrier created using this default.
|
Permitted Values:
|
|
Default:
|
Contains the value for the “stop_when_done” property for newly created action points. This property defines what else 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 as follows:
Stops only the threads in the satisfaction set; other threads are not affected. For process barriers, there is no difference between process and none.
|
Permitted Values:
|
|
Default:
|
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:
For example, if the front-end hostname is fred, TotalView assumes that the servers are connecting to fred-io.
|
Permitted Values:
|
|
Default:
|
TV::bluegene_server_launch_string
Defines the launch string used when launching tvdsvr processes on I/O nodes.
|
Permitted Values:
|
Specifies the number of seconds to wait to hear back from the TotalView Debugger Server (tvdsvr) that it launches.
|
Permitted Values:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
When true, uses bulk launch features when automatically launching the TotalView Debugger Server (tvdsvr) for remote processes.
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
If true, uses C type string extensions to display character arrays; when false, uses string type extensions.
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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 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:
|
|
Default:
|
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:
|
|
Default:
|
TV::checksum_libraries
|
Default:
|
Allocates the patch space dynamically at the given address. See “Allocating Patch Space for Compiled Expressions” in the TotalView Users Guide.
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
TV::compile_expressions
On an IBM AIX system, you can use the –use_aix_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:
|
|
Default:
|
(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.
–compiler_vars: sets this variable to true
–no_compiler_vars: sets this variable to false
|
Permitted Values:
|
|
Default:
|
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.
|
Permitted Values:
|
|
Default:
|
A read-only string containing the copyright information displayed when you start the CLI and TotalView.
If true, the C++View facility allows the formatting of program data in a more useful or meaningful form than the concrete representation visible by default when you inspect data in a running program. For more information on using C++View, see “C++View”.
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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 and is as follows:
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.
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.
Equivalent to the printf() function’s %d specifier. You can use this with integer and floating-point numbers.
Equivalent to the printf() function’s %x specifier. You can use this with integer and floating-point numbers.
Equivalent to the printf() function’s %o specifier. You can use this with integer and floating-point numbers.
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.
A positive integer. This is the same width specifier used in the printf() function.
. (period)
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)
|
Permitted Values:
|
|
Default:
|
{auto %-1.15 %-1.15 %-20.2}
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
Names the default subset specification listing MPI ranks to attach to when an MPI job is created or attached to.
|
Permitted Values:
|
|
Default:
|
When true, TotalView appends stderr information to the file set in the GUI or in the TV::default_stderr_filename variable. If no pathname is set, the value of this variable is ignored.
|
Permitted Values:
|
|
Default:
|
Names the file to write stderr information.
|
Permitted Values:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
Names the file from which to read stdin information.
|
Permitted Values:
|
|
Default:
|
When true, TotalView appends stdout information to the file set in the GUI or in the TV::default_stdout_filename variable. If no pathname is set, the value of this variable is ignored.
|
Permitted Values:
|
|
Default:
|
Names the file to write stdout information.
|
Permitted Values:
|
|
Default:
|
TV::display_assembler_symbolically
When true, TotalView displays assembler locations as label+offset. When false, these locations are displayed as hexadecimal addresses.
|
Permitted Values:
|
|
Default:
|
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:
|
|
|
|
The suffix of the library being loaded does not match a suffix contained in the TV::dll_stop_suffix variable.
|
|
Permitted Values:
|
A list of path names, each item of which is separated from another by a colon
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
Contains a colon-separated list of suffixes that stop the current process when it loads a library file with this suffix.
|
|
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
Controls the amount of information displayed when you use the dwhere command. Here are three examples:
dset TV::dwhere_qualification_level +overload_list \
-class_name -parent_function
-class_name -parent_function
In these examples “+” means that the information should be displayed and “-” means the information should not be displayed.
The all argument is often used as follows:
This states that all elements are displayed except for a parent function. For more information on these arguments, see “symbol”
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
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=valiue”.
To set this variable from within TotalView, use the File > New Program or Process > Startup dialog boxes.
|
Permitted Values:
|
|
Default:
|
When a value greater than 0, allows TotalView to pickup threads created using the clone() system call. The values can set are as follows:
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.
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
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 “/”.
|
|
Permitted Values:
|
|
Default:
|
This variable affects only those cases where TotalView preloads the agent. It names the directory in which TotalView will look for the hia for a local job. The default is the value of TV::hia_local_installation_dir. Change this variable if you want TotalView to look for the agent in a different directory.
A read-only variable that names the directory where the hia distributed with the executing instance of TotalView is found.
This variable affects only those cases where TotalView preloads the agent. It names the directory on a remote host where TotalView will look for the hia that is to be used by the remote job. If the variable is not set, the server uses its default, which is the same as the default value of the server’s TV::hia_local_dir but is interpreted in the remote file system.
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:
|
|
Default:
|
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:
|
|
User code uses dlopen() to load a new image.
|
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
Names a Tcl function to run before TotalView kills a process. The contents of this variable is a list of pairs. For example:
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:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
|
Permitted Values:
|
|
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.
|
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:
|
|
Default:
|
(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:
|
|
Default:
|
(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:
|
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:
|
|
Default:
|
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 except for SiCortex TotalView, where TV::platform is “linux-x86-64-x-linux-mipsel64” and TV::native_platform is “linux-x86-64.”
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
|
|
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:
|
|
Default:
|
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.
Tells TotalView if it should automatically run processes when your program launches them. Your choices are as follows:
|
|
yes: Stop the processes before they begin executing.
|
|
|
no: Do not interfere with the processes; that is, let them run.
|
|
|
ask: Display a question box asking if it should stop before executing.
|
|
Permitted Values:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
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:
|
|
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.
|
When true, enables debugging of the ORNL (Oak Ridge National Laboratory) implementation of Parallel Virtual Machine (PVM) applications. This variable can be set only in a start up script. However, you can override this value by using the following command-line options:
–pvm sets this variable to true
–no_pvm sets this variable to false
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
|
|
1: Discards the oldest history and continue.
|
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
When true, TotalView uses its single-process server launch procedure when launching remote tvdsvr processes. When false, tvdsvr is not automatically launched.
|
Permitted Values:
|
|
Default:
|
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 rsh command to start the server, but you can use any other command that can invoke tvdsvr on a remote host. If no command is available for invoking a remote process, you can’t automatically launch the server; therefore, you should set this variable to /bin/false. If you cannot automatically launch a server, you should also set the TV::server_launch_enabled variable to false. For information on this launch string, see “Replacement Characters”.
|
Permitted Values:
|
|
Default:
|
{%C %R –n "%B/tvdsvr –working_directory %D –callback %L –set_pw %P –verbosity %V %F"}
|
Specifies the number of seconds to wait for a response from the TotalView Debugger Server (tvdsvr) that it has launched.
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
A signal_list is a list of one or more signal specifiers, separated by commas:
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 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:
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:
|
2
|
|
3
|
|
Permitted Values:
|
|
Default:
|
This differs from platform to platform; type dset TV::signal_handling_mode to see what a platform’s default values are
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
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 as follows:
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
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++}
|
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-cell 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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
|
Permitted Values:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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 visualize 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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|
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:
|
|
Default:
|