Single Debug Server Launch

You can modify the TotalView Debugger Server (tvdsvr) Auto Launch feature by specifying the parameters TotalView will use to start this server on a remote host. By default, TotalView attempts to use the rsh command (remsh on HP-UX). Chapter 5 of the TotalView User's Guide contains a detailed description of these operations, along with instructions for starting the server manually if that becomes necessary. Here is a a brief summary of the automatic feature:

Enable single debug server launch

When this box is checked, TotalView automatically starts a server process when you ask it to debug a process on a remote host.

Note   Even if you have enabled bulk server launch, you probably also want this option to be enabled. TotalView uses this launch string when you start TotalView upon a file when you have named a host within the File > New Program dialog box or have used the -remote command line option. You only want to disable single server launch when it can't work.

Command

The command TotalView uses when it starts the (remote) server. You must include the -callback and -set_pw arguments.

Timeout

Time in seconds that TotalView will wait before giving up trying to establish a connection.

Defaults

Changes the values defined within this area to their default values. This action overrides changes you have made using this preference, or to values set using options or X resources.

The expansion strings and options that you can use in the launch command string are:

%C

Expands to the default name of the command used to start a remote process. If defined, the value of the environment variable TVDSVRLAUNCHCMD is used. Otherwise, the default name is rsh (remsh on HP-UX).

%R

Expands to the hostname of the remote machine as specified in the File > New Program dialog box.

-n

Tells the remote shell to read standard input from /dev/null.

-working_directory %D

Expands to the full path of the current working directory in which TotalView is running. The default command string tells tvdsvr to first try to cd to this directory. This directory name may be inappropriate if the target system's file system is not organized the same way as the host's file system.

-callback

Tells the server to call back to TotalView. This must be followed by the hostname and TCP/IP port number to call back to.

%L

Expands to the hostname and TCP/IP port number on which TotalView is listening for connections from tvdsvr.

%H

Expands to the hostname on which TotalView is running.

%S

Expands to the TCP/IP port number on which TotalView is listening for connections from tvdsvr.

-set_pw

Sets a 64-bit password for security. TotalView must supply this password when tvdsvr establishes the connection with it.

%P

Expands to the password that TotalView automatically generated.

%V

Expands to the TotalView verbosity setting. This launches the TotalView Debugger Server with the same verbosity level as TotalView.