Options

-a args

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

-background color

Sets the general background color to color.

Default: light blue

-bg color

Same as -background.

-compiler_vars

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

Some Fortran compilers (HP f90/f77, HP f90, SGI 7.2 compilers) output debugging 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 to display these variables. This is useful when you are looking for a corruption of a run-time descriptor or are writing a compiler.

-no_compiler_vars

(Default) Tells TotalView that it should not show variables created by the Fortran compiler.

-dbfork

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

-no_dbfork

Tells TotalView that it should 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 demangler and mangler TotalView uses by default. The following indicate override options.

-demangler=compaq:     HP cxx on Linux (alpha)

-demangler=dec:     HP Tru64 C++ or Fortran

-demangler=gnu:     GNU C++ on Linux Alpha

-demangler=gnu_dot:     GNU C++ on Linux x86

-demangler=gnu_v3:    GNU C++ Linux x86

-demangler=hp:     HP aCC compiler

-demangler=irix:     SGI IRIX C++

-demangler=kai:     KAI C++

-demangler=kai3_n:     KAI C++ version 3.n

-demangler=kai_4_0:    KAI C++

-demangler=spro:     SunPro C++ 4.0 or 4.2

-demangler=spro5:     SunPro C++ 5.0 or later

-demangler=sun:     Sun CFRONT C++

-demangler=xlc:     IBM XLC/VAC++ compilers

-display displayname

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

Default: The value of your 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 dlopens 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

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

-no_dpvm

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

-dump_core

Allows TotalView to dump a core file of itself when an internal error occurs. This is used to help Etnus debug TotalView problems.

-no_dumpcore

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

-e commands

Tells TotalView to immediately execute the CLI commands named within this argument. All information you enter here is sent directly to the CLI's Tcl interpreter. For example, the following writes a string to stdout:

    cli -e 'puts hello'

You can have more than one -e option on a command line.

-foreground color

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

Default: black

-fg color

Same as -foreground.

-f9x_demangler=compiler

Overrides the Fortran demangler and mangler TotalView uses by default. The following indicate override options.

-demangler=spro_f9x_4:     SunPro Fortran, 4.0 or later

-demangler=xlf:     IBM Fortran

-global_types

(Default) Lets TotalView 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 in a program. You should specify this option if your code has multiple different definitions of the same named type, since otherwise TotalView can use the wrong definition for an opaque type.

-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 TV::kcc_classes variable for a description of the conversions that TotalView performs.

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

-lb

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

-nlb

Tells TotalView that it should not automatically load action points 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 you are debugging an MPI program. This might be useful if something 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 run-time libraries such as MPI, PE, and UPC.

-no_parallel

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

-patch_area_base address

Allocates the patch space dynamically at the given address. See "Allocating Patch Space for Compiled Expressions" in Chapter 14 of the TotalView Users Guide.

-patch_area_length length

Sets the length of the dynamically allocated patch space to the specified length. See "Allocating Patch Space for Compiled Expressions" in Chapter 14 of the TotalView Users Guide.

-pid pid

Tells TotalView to attach to process pid after it starts executing.

-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 "Setting Single Process Server Launch" in Chapter 14 of the TotalView Users Guide.

-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 be either an absolute or relative name.

You can have more than one -s option on a command line.

-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" in Chapter 4 of the TotalView Users Guide.

-search_path pathlist

Specify a colon-separated list of directories that TotalView will search when it looks for source files. For example:

totalview -search_path proj/bin:proj/util

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

An action_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, For more information on the meaning of each action, see Chapter 3 of the TotalView Users Guide.

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 that you use the signal name rather than the number because number assignments vary across UNIX sessions.

The following rules apply when you are specifying an action_list:

(1) If you specify an action for a signal in an action_list, TotalView changes the default action for that signal.

(2) If you do not specify a signal in the action_list, TotalView does not change its default action for the signal.

(3) If you specify a signal that does not exist for the platform, TotalView ignores it.

(4) If you specify an action for a signal more than once, TotalView uses the last action specified.

If you need to revert the settings for signal handling to TotalView's built-in defaults, use the Defaults button in the File > Signals dialog box.

For example, here's how to set the default action for the SIGTERM signal to resend:

    "Resend=SIGTERM"

Here's how to set the action for SIGSEGV and SIGBUS to error, the action for SIGHUP to resend, and all remaining signals to stop:

    "Stop=* Error=SIGSEGV,SIGBUS Resend=SIGHUP"

-shm "action_list"

Same as -signal_handling_mode.

-tvhome pathname

The directory from which TotalView reads preferences and other related information and the directory to which it writes this information.

-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