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

Defined only on AIX, a synonym for the platform-independent -use_fast_wp, for TotalView script backward compatibility. See -use_fast_wpfor more information.You must set this option on the command line; you cannot set it interactively using the CLI.

Defined only on AIX, a synonym for the platform-independent -use_fast_trap, for TotalView script backward compatibility. See -use_fast_trapfor more information. You must set this option on the command line; you cannot set it interactively using the CLI.

Specifies filename as the executable to debug, with args as optional arguments to pass to your program. This option must be listed last on the command line. You can also use --args instead of-args, for compatibility with other debuggers.

Sets the general background color to color.

Same as -background.

(Default). TotalView attempts to extract a unique ID from an image file before checksumming it. For detail, see the state variable TV::check_unique_id.

(Default). TotalView checksums image files across nodes in a parallel debugging session. This setting is impacted by the setting for -check_unique_id. For detail, see the state variable TV::checksum_­libraries.

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

(Default) Kills attached processes and exits.

Invokes code that sometimes allows TotalView to better manage the way it kills parallel jobs when it works with management systems. This has only been tested with SLURM. It may not work with other systems.

(Default) Enables CUDA debugging with TotalView.

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

Redirects TotalViewconsole output to a file namedconsole_outputfile.

If consoleoutputfile is the string UNIQUE, the filename tv_dump.hostname.pid is used. If console_outputfile contains the string '$$' (note the escaping single quotes), hostname.pid is substituted. UNIQUE and '$$' are useful for separating the console output when running multiple tvdsvr processes.

All TotalView console output is written to stderr.

Specifies a set of MPI ranks to be attached to when an MPI job is created or attached to. The subset_specification is a space-separated list, the elements of which can be in one of these forms:

rank: that rank only

rank1-ranks2: all ranks between rank1 and rank2 inclusive

rank1-rank2:stride: every strideth rank between rank1 and rank2

A rank must be either a positive decimal integer or max (the last rank in the MPI job).

A subset_specification that is the empty string ("") is equivalent to 0-max.

The default_parallel_attach_subset is used to initialize the -parallel_attach_subset property of an MPI starter process, which can be get or set in the CLI using:

The CLI dattachanddload -parallel_attach_subset-subset_specification overrides the default_parallel_attach_subset and sets the parallel_attach_subset property of the process being attached or loaded.

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

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

-demangler=gnu_v3: GNU C++ Linux x86

-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

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

The colon-separated argument to this option sets TotalView to 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.

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

(Default). Reevaluates breakpoint specifications on every dlopen call.

This setting impacts scalability in HPC computing environments. For details, see Filtering dlopen Events.

Default: "" (the empty string)

Contains a glob-list of patterns used to match against the path name of a dlopened library. If ‑dlopen_always_recalculate is set (the default), the value of this variable is ignored. When ‑no_dlopen_always_recalculate is set and a dlopen event occurs, TotalView matches the name of the dlopened library against the glob-list. Be careful to quote the glob-list to prevent shell expansion. For example, if a glob-list contains special characters such as *, ?, [, ], and !, be sure to quote the characters to prevent the shell from interpreting them. Note that some shells, like tcsh, will expand ! even when it is enclosed in double or single quotes, which requires escaping the ! with a backslash. For example, '\!*/libfoo*' will prevent a tcsh shell from expanding !* from history, and result in the glob-list being set to '!*/libfoo*'.

For a complete explanation of dlopen event filtering, including use-case examples, please refer to Filtering dlopen Events.

Enables dlopen events to be handled in parallel, reducing client/server communication overhead by using MRNet to fetch the library information.

This setting impacts scalability in HPC computing environments. For details, see Filtering dlopen Events.

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

(Default). Allows TotalView to use the DWARF global index sections (.debug_pubnames, .debug_pubtypes, .debug_typenames, etc.) in executable and shared library image files.

Immediately executes 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:

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

Uses only an Enterprise license.

Adds an environment variable to the environment variables passed to your program by the shell. If the variable already exists, it effectively replaces the previous value. You need to use this command for each variable being added; that is, you cannot add more than one variable with an env command.

Default: "" (the empty string)

Controls how TotalView responds when a process being debugged calls execve().

This option’s argument, exec-handling-list, is a Tcl list of regexp and action pairs. The regexp contains the name of the parent process, and action defines an action for TotalView to take.

When a process that is being debugged execs a new executable, TotalView iterates over exec-handling-list to match the original process name (that is, the name of the process before the exec happened) against each regexp in the list. If it finds a match, it uses the corresponding action.

If a matching process name is not found in the exec-handling-list, the value of the TV::parallel_stop CLI state variable preference is used.

For more information, see “Controlling fork, vfork, and execve Handling” in the Classic TotalView User Guide.

Default: "" (the empty string)

Controls how TotalView launches or attaches to new processes.

This option’s argument, fork-handling-list, is a Tcl list of regexp and action pairs. The regexp contains the name of the parent process, and action defines how future fork system calls will be handled for this process.

When first launching or attaching to a process, TotalView iterates over fork-handling-list to match the process name against each regexp in the list. When it finds a match, it uses the corresponding action to determine how future fork system calls will be handled

If a matching process name is not found in fork-handling-list, TotalView handles fork() based on whether the process was linked with the dbfork library and the setting of the TV::dbforkCLI state variable preference.

For more information, see “Controlling fork, vfork, and execve Handling” in the Classic TotalView User Guide.

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

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

(Default). Allows TotalView to use the .gdb_index section in executable and shared library image files.

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

If this option is set, TotalView attempts 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.

For a program or library with either (or both) a build ID or .gnu_debug_link section, TotalView looks for a separate debug file. If found, TotalView reads this file’s debugging information. The related state variable is TV::gnu_debuglink.

Sets the TV::gnu_debuglink_build_id_search_path variable to specify a build ID search path string.

For a program or library with either (or both) a build ID or .gnu_debug_link section, compare build IDs if the base image file contains a build ID.

Works in concert with -gnu_debuglink_checksum to define how to validate a separate debug info file, if one exists, against a base image file that references it. See the variables TV::gnu_debuglink_check_build_id and TV::gnu_debuglink_checksum for detail on how these options’ settings impact one another.

Validates the debug file’s checksum against the checksum contained in the image’s .gnu_debuglink section.

Works in concert with -gnu_debuglink_check_build_id to define how to validate a separate debug info file, if one exists, against a base image file that references it. See the variables TV::gnu_debuglink_check_build_id and TV::gnu_debuglink_checksum for detail on how these options’ settings impact one another.

Sets the TV::gnu_debuglink_global_directory variable that names the global directory that stores debug files.

Sets the TV::gnu_debuglink_search_path variable to specify a search path string.

Directs TotalView to support IPv6 addresses.

Enables Clang / LLVM JIT debugging. See TV::jit_debugging for details.

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

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

Loads into TotalView the session named in session_name. If the preference “Show Startup Parameters when TotalView starts” is set, this option launches the Session Manager’s Program Session screen where you can edit the session’s properties and then launch the session; otherwise, the option immediately loads the session into TotalView, launching the Root and Process windows.Session names with spaces must be enclosed in quotes, for example, "my debug session". Sessions that attach to an existing process cannot be loaded using this option; rather, use the -pid option instead.

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

Enables memory debugging. By adding the following suboptions, you enable that particular feature using its the feature’s default configuration. In most cases, you will want to use one or more of the following sub-options.

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

Names the MPI that your program requires. The list of starter names that you enter are those that appear in the Parallel system pull down list contained within the New Program’s Parallel tab. If the starter name has more than one word (for example, Open MPI), enclose the name in quotes. For example:

A Tcl regular expression matching the name of the mpibind program (or any program) that the MPI starter process launches, instead of directly launching the MPI application.

For detail, see the state variable TV::mpibind_regexp.

Controls the use of an MRNet proxy server. The default is auto, which uses an MRNet proxy server only if necessary.

For detail, see the state variable TV::mrnet_proxy_server.

Sets the state variable TV::mrnet_super_bushy to true. When set, TotalView creates a "super bushy" MRNet tree. For detail, see the state variable TV::mrnet_super_bushy.

Launches the modernTotalView UI rather than the TotalView UI

Specifies the number of nodes upon which the MPI job will run.

Sets TotalView to not reference any initialization files during startup. Note that this negates all settings in all initialization files. Aliases are -nostartupscripts and -nss.

By default, the cursor in the source pane of the process window turns into a hand cursor when hovering over an element you can dive on (a red box is also drawn around the applicable code). Specify this option to override this behavior and retain the usual arrow cursor.

Specifies how many tasks that TotalView should launch for the job. This argument usually follows a -mpi command-line option.

Sets your application to use NPTL threads. You need use this option only if TotalView cannot determine that you are using this threads package.

Does not use the NPTL threads package. Use this option if TotalView thinks your application is using it and it isn’t.

Displays the Root Window used in versions prior to TotalView 8.15.0. Using ‑-oldroot or -‑newroot overrides the TV::GUI::old_root_window value.

Enables or disables OpenMP runtime support by setting the variable TV::openmp_debug_enabled.

(Default) Enables handling of parallel program run-time libraries such as MPI, PE, and UPC.

Sets the action that TotalView takes when starting a parallel program. Possible options are:

yes (default) Attaches to all processes in a parallel program, unless the process being launched or attached to has a non-empty parallel_attach_subset property. In this case, only the subset of processes specified in the parallel_attach_subset are attached.

no: Attaches to no processes in a parallel program.

ask Asks which processes to attach to by posting the subset attach dialog box if the debugger GUI is open.

This option works in concert with the parallel_attach_subset property (see -default_parallel_attach_subset) of an MPI starter process, which specifies a set of MPI tasks to attach to when the debugger launches or attaches to an MPI job.

Modifying this setting does not affect the parallel_attach_subset property itself.

Allocates the patch space dynamically at address. See “Allocating Patch Space for Compiled Expressions” in the TotalView User Guide.

Sets the length of the dynamically allocated patch space to this length. See “Allocating Patch Space for Compiled Expressions” in the Classic TotalView User Guide.

Attaches to process pid for executable filename when TotalView starts executing.

Specifies how many tasks that TotalView should launch for the job. This argument usually follows a -mpi command-line option.

Displays the Processes/Ranks Tab in the Process Window. Note that enabling this tab can significantly affect performance, particularly for large, massively parallel applications.

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 the Classic TotalView User Guide.

Enables the ReplayEngine when TotalView begins. This command-line option is ignored if you do not have a license for ReplayEngine. You may also use the alias -reverse_debugging.

Enables listening for reverse connections when TotalView launches. This is the default.

See the related state variable TV::reverse_connect_wanted.

(Default) Enables AMD ROCm debugging with TotalView.

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 add more than one-s option on a command line.

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 the Classic Classic TotalView User Guide.

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

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 Accessing TotalView Remotely in the Classic TotalView User 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) Specifying an action for a signal in an action_list changes the default action for that signal.

(2) Not specifying a signal in the action_list does not change its default action for the signal.

(3) Specifying a signal that does not exist for the platform results in TotalView ignoring it.

(4) Specifying an action for a signal more than once results in TotalView using the last action specified.

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, here’s how to set the default action for the SIGTERM signal to resend:

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:

Same as -signal_handling_mode.

Passes arguments to the starter program. You can omit the quotation marks if arguments is just one string without any embedded spaces.

Controls the behavior of reading delayed symbols while building a stack backtrace in order to find inlined subroutines. Possible options are auto, true, or false. The default is auto, meaning that TotalView attempts to automatically detect whether the subroutine associated with a stack frame might contain inlined subroutines; if so, it reads the delayed symbols for the file containing the subroutine.

For more information, see the state variable TV::stack_trace_expand_inlined_subroutines.

Names the file to which TotalView writes the target program’s stderr information while executing within TotalView. If the file exists, TotalView overwrites it. If the file does not exist, TotalView creates it.

Appends the target program’s stderr information to the file named in the -stderr command, specified in the GUI, or in the TotalView TV::default_stderr_filename variable. If the file does not exist, TotalView creates it.

Redirects the target program’s stderr to stdout.

Names the file from which the target program reads information while executing within TotalView.

Names the file to which TotalView writes the target program’s stdout information while executing within TotalView. If the file exists, TotalView overwrites it. If the file does not exist, TotalView creates it.

Appends the target program’s stdout information to the file named in the -stdout command, specified in the GUI, or in the TotalView TV::default_stdout_filename variable. If the file does not exist, TotalView creates it.

Specifies how many tasks TotalView should launch for the job. This argument usually follows a -mpi command-line option.

Uses only a Team license.

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

Controls TotalView’s use of the target operating system’s support of the fast trap mechanism for compiled conditional breakpoints, also known as EVAL points. You must set this option on the command line; you cannot set it interactively using the CLI.

Your operating system may not be configured correctly to support this option. See the Classic TotalView Release Notes on the TotalView documentation page for more information.

Controls TotalView’s use of the target operating system’s support of the fast trap mechanism for compiled conditional watchpoints, also known as CDWP points. You must set this option on the command line; you cannot set it interactively using the CLI.

Your operating system may not be configured correctly to support this option. See the Classic TotalView Release Notes on the TotalView documentation page for more information.

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

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

Sets the working directory for executing a target program, overwriting the default.

Sets the name of the program used when TotalView needs to create a the CLI. If you do not use this command or have not set the TV::xterm_name variable, TotalView attempts to create an xterm window.