TotalView Online Help : Chapter 1 Root Window : File Menu Commands : File > Debug New Program
File > Debug New Program
Configure your debugging session in the Program Session dialog which launches at its Program Details tab.
Program Details
 
Figure 4 – Program Details
1. Enter a session name in the Session Name text box.
 
NOTE >> Any previously entered sessions of the same type are available from the Session Name dropdown box. See “Editing or Starting New Sessions in a Sessions Window.”
2 Enter the name of your program in the File Name box or press Browse to browse to and select the file. You can enter a full or relative path name. If you have previously entered programs here, they will appear in a drop-down list.
If you enter a file name, TotalView searches for it in the list of directories named using the File > Search Path command or listed in your PATH environment variable.
CLI: dset EXECUTABLE_PATH
3. (Optional) Add any custom configurations or options:
Remote debugging: Select or add a remote host, if the program is to be executed on a remote computer. See "Adding a Remote Host".
Program arguments: Enter any program arguments into the Arguments field.
Because you are loading the program from within TotalView, you will not have entered the command-line arguments that the program needs. See "Program Arguments".
Debugging Options: See "Debug Options".
Environment variables or standard I/O: See "Setting Environment Variables and Altering Standard I/O"
Notes: You can add any notes to the session by selecting the Note icon (). See "Adding Notes to a Session".
4. Click Start Session. The Start Session button is enabled once all required information is entered.
If the process has children that called execve(), TotalView tries to determine each child’s executable. If TotalView cannot determine the executables for the children, you need to delete (kill) the parent process and start it under TotalView control.
If the executable is a multiprocess program, TotalView asks if you want to attach to all relatives of the process. To examine all processes, select Yes.
 
NOTE >> This is the default behavior. You can change this behavior by using commands within the File > Preference’s Parallel Page.
related topics
“Managing Sessions” in the TotalView for HPC User Guide
“Loading Programs from the Sessions Manager” in the TotalView for HPC User Guide
“Debugging a New Program” in the TotalView for HPC User Guide