Totalview® for HPC User Guide : PART IV Advanced Tools and Customization : Chapter 18 Setting Up Remote Debugging Sessions : TotalView Server Launch Options and Commands : Customizing Server Launch Commands : Setting the Single-Process Server Launch Command
Setting the Single-Process Server Launch Command
You can customize the default command string that TotalView uses when it automatically launches TotalView server for a single process. This string is accessible via the File >Preferences > Launch Strings dialog in its Command text box:
 
This is the default command string:
%C %R -n "%B/tvdsvr -working_directory %D -callback %L \
 -set_pw %P -verbosity %V %F"
where:
%C
Expands to the name of the server launch command to use, which is the value of TV::launch_command. On most platforms, this is ssh -x. On Sun SPARC computers, it is rsh. If the TVDSVRLAUNCHCMD environment variable exists, TV::launch_command is initialized to its value.
%R
Expands to the host name of the remote computer specified in the File > Debug New Program (and other Session Manager dialog boxes) or dload commands.
%B
Expands to the bin directory in which tvdsvr is installed.
-n
Tells the remote shell to read standard input from /dev/null; that is, the process immediately receives an EOF (End-Of-File) signal.
-working_directory %D
Makes %D the directory to which TotalView connects. %D expands to the absolute path name of the directory.
When you use this option, the host computer and the target computer must mount identical file systems. That is, the path name of the directory to which TotalView connects must be identical on host and target computers.
After changing to this directory, the shell invokes the tvdsvr command.
You must make sure that the tvdsvr directory is in your path on the remote computer.
-callback %L
Establishes a connection from tvdsvr to TotalView. %L expands to the host name and TCP/IP port number (hostname:portnumber) on which TotalView is listening for connections from tvdsvr.
-set_pw %P
Sets a 64-bit password. TotalView must supply this password when tvdsvr establishes a connection with it. TotalView expands %P to the password that it automatically generates. For more information on this password, see “TotalView Debugger Server (tvdsvr) Command Syntax” in the TotalView for HPC Reference Guide.
-verbosity %V
Sets the verbosity level of the tvdsvr. %V expands to the current verbosity setting. For information on verbosity, see the “Variables” chapter within the TotalView for HPC Reference Guide.
%F
Contains the tracer configuration flags that need to be sent to tvdsvr processes. These are system-specific startup options that the tvdsvr process needs.
You can also use the %H option with this command. See "Setting the Bulk Server Launch Command" for more information.
For information on the complete syntax of the tvdsvr command, see “­TotalView Debugger Server (tvdsvr) Command Syntax” in the TotalView for HPC Reference Guide.