Starting TotalView

TotalView can operate on programs that run in many different computing environments and which make use of a variety of parallel processing modes. This section looks at general ways to start TotalView. More detailed information can be found in TotalView Command Syntax.

The basic command structure for starting TotalView is:

    totalview [ executable [ corefile ] ] [ options ]

where executable specifies the name of the executable file to be debugged and corefile specifies the name of the core file to be debugged.

Note:   If you are starting the CLI, you will type "totalviewcli" rather than "totalview".

Here are some of the common ways to start TotalView:

totalview

Starts TotalView without loading a program or core file. After TotalView starts, you can load a program by using the File > New Program command from the Root Window.

totalview executable

Starts TotalView and loads the executable program.

totalview executable corefile

Starts TotalView and loads the executable program and the corefile core file.

totalview executable -a args

Starts TotalView and passes all following arguments (specified by args) to the executable program. If you use the -a option, it must appear after all other TotalView options on the command line. If you do not use -a and want to add arguments after TotalView loads your program, use the Process > Startup command.

totalview executable -remote hostname_or_address[:portnumber]

Starts TotalView on the local host and the TotalView Debugger Server (tvdsvr) on the remote host. Loads the program specified by executable for remote debugging. You can specify a host name or a TCP/IP address, and optionally, a TCP/IP port number for portnumber.

Within a debugging session, you can reload programs and shared libraries. If these executable files have changed since you started debugging your program and you do not use the Group > Reload Symbols command (see Reloading a Recompiled Executable) to reload them, TotalView displays an error message because its symbol tables would not be up-to-date.

For more information on:

• Debugging parallel programs such as MPI, PVM, or HPF, refer to Setting Up Parallel Debugging Sessions.
   
• The totalview command, refer to TotalView Command Syntax.
   
• Remote debugging, refer to Starting the TotalView Debugger Server and TotalView Debugger Server (tvdsvr) Command Syntax.

Your installation may have its own procedures and guidelines for running TotalView. Your site administrator may have made a link to information located on your site.