File > New Program

Use this dialog box to specify the name of a new executable file, to attach to an existing running process or core file, or to specify the location of the process.

The New Program dialog box allows you to load another program. When loading a program, you need to enter and indicate:

• The name of your program's executable file.
• Whether or not to attach to an existing process or core file.
• The location of the process, which can be Local, Remote Host, or Serial Line.
   

The simplest case is when you want to debug a new program on a local host. Type the name of a program you wish to debug in the Executable field and press OK.

If you want to attach to an existing process or read a core file, specify a Process ID or enter a name in the Core File field. In both of these cases, you must also enter a pathname in the Executable field.

If you want to debug a process on a remote machine, enter the host name or IP address of the remote machine in the Remote Host field.

The fields in this dialog box and their meaning are:

Executable

The name of the executable file to be debugged. You can enter either a full or relative path name. If you enter just a file name, TotalView searches for the file in the directories you specified with the File > Search Path command and in all the directories named in your PATH environment variable.

You can use the Browse button to search the file system for the file.

Attach To

Lets you attach to an already running program or to load a core file.

New Process

If selected, TotalView loads the executable. If the executable is already loaded, TotalView loads it again.

Core file

If selected, TotalView loads the core file. You must enter a program name in the Executable field because TotalView cannot know if this program is actually associated with the process.

You can use the Browse button to search the file system for the core file.

Process ID

If selected, TotalView loads the program associated with this process ID. A program name must be entered in the Executable field because TotalView cannot check that this program is actually associated with the process.

If this process is already loaded, TotalView raises the window; that is, it makes the process's window completely visible.

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.

Target Location

Lets you indicate the program's location, as follows:

Local

The program is on your current machine.

Remote Host

The program is on a different machine and TotalView will access it over your network.

Serial Line

The program is on a different machine and TotalView will access it over a serial line.