Options

-a args

Passes all subsequent arguments (specified by args) to the program specified by filename. This option must be the last one on the command line.

-ask_on_dlopen

(Default) TotalView will ask you about stopping processes that dynamically load a new shared library by using the dlopen or load (AIX only) system calls. See Debugging Dynamically Loaded Libraries.

-no_ask_on_dlopen

TotalView will not ask you about stopping processes that dynamically load a new shared library by using the dlopen or load (AIX only) system calls. See Debugging Dynamically Loaded Libraries.

-background color

Sets the general background color to color.

Default: white

-bg color

Same as -background.

-barr_stop_all

(Default) Enables process barrier breakpoints to stop all related processes.

-no_barr_stop_all

The process barrier breakpoint does not stop all related processes.

-bulk_launch_base_timeout time_in_seconds

Sets the time to wait before giving up trying to establish the connections. The total timeout is calculated as a base value (this option), in addition to an amount for each server launched. That time is specified using the -bulk_launch_incr_timeout value.

-bulk_launch_incr_timeout time_in_seconds

Sets the time to wait before giving up trying to establish the connections. The total timeout is calculated as a base value (indicated with the -bulk_launch_-base_timeout command) and an amount for each server launched (this option).

-bulk_launch_string string

Defines the launch string used to launch the bulk server. See the Bulk Launch Page within the File > Preferences dialog box for more information.

-bulk_launch_tmpfile1_header string

Defines the first temporary header file that will be created during a bulk server launch. See the Bulk Launch Page within the File > Preferences dialog box for more information.

-bulk_launch_tmpfile1_host_string string

Defines the first host string sent to the remote process during a bulk server launch. See the Bulk Launch Page within the File > Preferences dialog box for more information.

-bulk_launch_tmpfile1_trailer_string string

Defines the first temporary trailer file that will be created during a bulk server launch. See the Bulk Launch Page within the File > Preferences dialog box for more information.

-bulk_launch_tmpfile2_header_string string

Defines the second temporary header file that will be created during a bulk server launch. See the Bulk Launch Page within the File > Preferences dialog box for more information.

-bulk_launch_tmpfile2_host_string string

Defines the second host string sent to the remote process during a bulk server launch. See the Bulk Launch Page within the File > Preferences dialog box for more information.

-bulk_launch_tmpfile2_trailer_string string

Defines the second temporary trailer file that will be created during a bulk server launch. See the Bulk Launch Page within the File > Preferences dialog box for more information.

-compiler_vars

(Alpha, HP, and SGI only.) Shows variables created by the Fortran compiler, as well as those in the user's program.

-no_compiler_vars

(Default) Does not show variables created by the Fortran compiler.

Some Fortran compilers (Compaq f90/f77, HP f90, SGI 7.2 compilers) output debug information that describes variables the compiler itself has invented for purposes such as passing the length of character*(*) variables. By default, TotalView suppresses the display of these compiler-generated variables.

However, you can specify the -compiler_vars option or set the totalview*compilerVars X resource to true to cause such variables to be displayed. This could be useful if you are looking for a corruption of a runtime descriptor or are writing a compiler.

-dbfork

(Default) Catches the fork(), vfork(), and execve() system calls if your executable is linked with the dbfork library.

-no_dbfork

Does not catch fork(), vfork(), and execve() system calls even if your executable is linked with the dbfork library.

-debug_file consoleoutputfile

Redirects TotalView console output to a file named consoleoutputfile.

Default: All TotalView console output is written to stderr.

-demangler=compiler

Overrides the C++ demangler and mangler TotalView uses by default. The following table lists override options.

Option	Meaning
-demangler=compaq	Compaq cxx on Linux (alpha)
-demangler=cset	IBM CSet++
-demangler=dec	Compaq Tru64 C++
-demangler=gnu	GNU C++
-demangler=hp	HP aCC compiler
-demangler=irix	SGI IRIX C++
-demangler=kai	KAI C++
-demangler=kai3_n	KAI C++ version 3.n
-demangler=spro	SunPro C++ 4.0 or 4.2
-demangler=spro5	SunPro C++ 5.0 or later
-demangler=sun	Sun CFRONT C++

-display displayname

Sets the name of the X Windows display to displayname. For example, -display vinnie:0.0 will display TotalView on the machine named "vinnie."

Default: To the value of the DISPLAY environment variable.

-dll_ignore_prefix list

The colon-separated argument to this option tells TotalView that it should ignore files having this prefix when making a decision to ask about stopping the process when it dllopens a dynamic library. If the DLL being opened has any of the entries on this list as a prefix, the question is not asked.

-dll_stop_suffix list

The colon-separated argument to this option tells TotalView that if the library being opened has any of the entries on this list as a suffix, it should ask if it should open the library.

-dpvm

Compaq Tru64 UNIX only: Enables support for debugging the Compaq Tru64 UNIX implementation of Parallel Virtual Machine (PVM) applications.

-no_dpvm

Compaq Tru64 UNIX only: (Default) Disables support for debugging the Compaq Tru64 UNIX implementation of PVM applications.

-dump_core

Allows TotalView to dump a core file when it gets an internal error. Useful for debugging TotalView itself.

-no_dumpcore

(Default) Does not allow TotalView to dump a core file when it gets an internal error.

-dynamic

(Default) Loads symbols from shared libraries. This option is available only on platforms that support shared libraries.

-no_dynamic

Does not load symbols from shared libraries when reading dynamically linked executables. Setting this option can cause the dbfork library to fail because TotalView might not find the fork(), vfork(), and execve() system calls.

-editor_launch_string string

Defines the launch string used to launch a text editor when you select the Process Window's File > Edit Source command. See the Launch Strings page within the File > Preferences dialog box for more information.

-ext extension

Specifies that files with the suffix extension are preprocessor input files. TotalView already has built-in extensions for C++ (.C, .cpp, .cc, .cxx), Fortran (.F), lex (.l, .lex), and yacc (.y) files.

-fixed_font_family fontname

Specifies the fixed-width font that TotalView uses when displaying your source code and other similar information. Use the -fixed_font_size option to specify the size at which this font is displayed.

It is usually better to specify this family by using a TotalView preference.

-fixed_font_size number

Specifies the size at which TotalView displays the font indicated with -fixed_font_family option.

It is usually better to specify this size by using a TotalView preference.

-foreground color

Sets the general foreground color (that is, the text color) to color.

Default: black

-fg color

Same as -foreground.

-global_types

(Default) Specifies that TotalView can assume that type names are globally unique within a program and that all type definitions with the same name are identical. In C++, the standard asserts that this must be true for standard conforming code.

If this option is set, TotalView will attempt to replace an opaque type (struct foo *p;) declared in one module, with an identically named defined type in a different module.

If TotalView has read the symbols for the module containing the non-opaque type definition, then when displaying variables declared with the opaque type, TotalView will automatically display the variable by using the non-opaque type definition.

-no_global_types

Specifies that TotalView cannot assume that type names are globally unique within a program. You should specify this option if your code has multiple different definitions of the same named type, since otherwise TotalView is likely to pick the wrong definition to substitute for an opaque type.

-hpf

(Default) Enables debugging HPF code at the source level.

-no_hpf

Disables debugging HPF source code at the source level.

-hpf_node

Enables display of the node on which the HPF distributed array element resides in the Process Window.

-no_hpf_node

(Default) Disables display of the node on which the HPF distributed array element resides in the Process Window.

-ignore_control_c

Ignores Ctrl-C and prevents you from terminating the TotalView process from an xterm window, which is useful when your program catches the Ctrl-C signal (SIGINT).

-icc

Same as -ignore_control_c.

-no_ignore_control_c

(Default) Catches Ctrl-C and terminates your TotalView debugging session. To override this, use -ignore_control_c.

-nicc

Same as -no_ignore_control_c.

-kcc_classes

(Default) Converts structure definitions output by the KCC compiler into classes that show base classes, and virtual base classes in the same way as other C++ compilers. See the description of the X resource totalview*kccClasses for a description of the conversion performed by TotalView.

-no_kcc_classes

Specifies that TotalView will not convert structure definitions output by the KCC compiler into classes. Virtual bases will show up as pointers, rather than the data.

-lb

(Default) Loads action points automatically from the filename.TVD.breakpoints file, providing the file exists.

-nlb

Does not load action points automatically from an action points file.

-message_queue

(Default) Enables the display of MPI message queues when debugging an MPI program.

-mqd

Same as -message_queue.

-no_message_queue

Disables the display of MPI message queues when debugging an MPI program. This might be useful if a store corruption is overwriting the message queues and causing TotalView to become confused.

-no_mqd

Same as -no_message_queue.

-parallel

(Default) Enables handling of parallel program runtime libraries such as MPI, PE, and HPF.

-no_parallel

Disables handling of parallel program runtime libraries such as MPI, PE, and HPF. This is useful for debugging parallel programs as if they were single-process programs.

-parallel_attach argument

Tells TotalView what is should do when automatically attaching to processes. The values you can enter are:

yes (attach to all started processes)

no (do not attach to any started process

ask (display a dialog box listing the processes and let the user decide which ones TotalView should attach to)

-parallel_stop argument

Tells TotalView if it should automatically run processes when your program launches them. The values you can enter 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 what it should do)

-patch_area_base address

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

-patch_area_length length

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

-pop_at_breakpoint

Sets the Open (or raise) process window at breakpoint check box to be selected by default. See Handling Signals.

-no_pop_at_breakpoint

(Default) Sets the Open (or raise) process window at breakpoint check box to be deselected by default.

-pop_on_error

(Default) Sets the Open (or raise) process window on error check box to be selected by default. See Handling Signals.

-no_pop_on_error

Sets the Open (or raise) process window on error check box to be deselected by default.

-pvm

Enables support for debugging the ORNL implementation of Parallel Virtual Machine (PVM) applications.

-no_pvm

(Default) Disables support for debugging the ORNL implementation of PVM applications.

-remote hostname[:portnumber]

Debugs an executable that is not running on the same machine as TotalView. For hostname, you can specify a TCP/IP host name (such as vinnie) or a TCP/IP address (such as 128.89.0.16). Optionally, you can specify a TCP/IP port number for portnumber, such as :4174. When you specify a port number, you disable the autolaunch feature. For more information on the autolaunch feature, see Single Process Server Launch Command.

-r hostname[:portnumber]

Same as -remote.

-s pathname

Specifies the path name of a startup file that will be loaded and executed. This path name can either be an absolute or relative name. You can find information on the contents of this start-up file in the CLI Guide.

-sb

Saves action points automatically to an action points file when you exit TotalView. The file is named filename.TVD.breakpoints.

-nsb

(Default) Does not save action points automatically to an action points file when you exit.

-serial device[:options]

Debugs an executable that is not running on the same machine as TotalView. For device, specify the device name of a serial line, such as /dev/com1. Currently, the only option you are allowed to specify is the baud rate, which defaults to 38400. For more information on debugging over a serial line, see Debugging Over a Serial Line.

-server_launch_string string

Defines the launch string used to launch a remote server. See the Launch Strings Page within the File > Preferences dialog box for more information.

-signal_handling_mode "action_list"

Modifies the way in which TotalView handles signals. You must enclose the action_list string in quotation marks to protect it from the shell. Refer to totalview*signalHandlingMode for a description of the action_list argument.

-shm "action_list"

Same as -signal_handling_mode.

-stop_all

(Default) Sets the Stop All Related Processes when Breakpoint Hit check box to be selected by default. To override this option use -no_stop_all. See Breakpoints for Multiple Processes.

-no_stop_all

Sets the Stop All Related Processes when Breakpoint Hit check box to be deselected by default.

-ui_font_family fontname

Specifies the variable-width font that TotalView uses. Use the -ui_font_size option to specify the size at which this font is displayed.

It is usually better to specify this family by using a TotalView preference.

-ui_font_size number

Specifies the size at which TotalView displays the font indicated with -ui_font_family option.

It is usually better to specify this size using a TotalView preference.

-user_threads

(Default) Enables handling of user-level (M:N) thread packages on systems where two-level (kernel and user) thread scheduling is supported.

-no_user_threads

Disables handling of user-level (M:N) thread packages. This option may be useful in situations where you need to debug kernel-level threads, but in most cases, this option is of little use on systems where two-level thread scheduling is used.

-verbosity level

Sets the verbosity level of TotalView-generated messages to level, which may be one of silent, error, warning, or info.

Default: info

-visualizer_launch_string string

Defines the launch string used to launch a visualizer when you select the Tools > Visualize command within the Variable Window or when TotalView encounters a $visualize intrinsic when it is evaluating an expression. See the Launch Strings Page within the File > Preferences dialog box for more information.

-visualizer_max_rank number

Specifies the number of array dimensions that are sent to a visualizer. If you are using TotalView's Visualizer, this value cannot be greater than 2. The maximum value you can specify is 16.