Attach to a Running Program

Use this screen to attach to a running program. While the process of attaching to a process within MemoryScape is quite simple—just select the process and click a button—MemoryScape cannot obtain memory debugging information from that file unless you either:

• Link in the Heap Interposition Agent (HIA) into the program before the program began executing. This is discussed in the Debugging Memory Problems with MemoryScape book.

Platform	Variable
Apple Mac OS X	DYLD_INSERT_LIBRARIES
IBM AIX	MALLOCTYPE
Linux	LD_PRELOAD
Sun	LD_PRELOAD
IBM Blue Gene/P and Blue Gene/Q	LD_PRELOAD

The best way to set this variable is by using the env command. For example, here’s how you would set this variable on a Linux system:

Either click Add Host to add a new remote host on which your program will execute, or select a previously named machine from the dropdown list. The machine entered must have the same architecture as the machine on which you are running MemoryScape, with the exception of those heterogeneous platforms described in Heterogeneous and Cross-Debugging on Linux, in the TotalView Platforms Guide. For example, if you are running MemoryScape on a linux-x86 machine, you cannot name a Sun Solaris system.

To enter a new host, select the Add host button and enter its name or IP address in the displayed dialog box.

To manually enter a connection string or to view the default string TotalView will use to launch the remote debug session, select the Advanced button (

) to open the Remote Server Launch Command field.

You can edit this string and then click Save as preference to have TotalView save it to your preferences. Once saved, you can view or edit it at File > Preferences > Launch Strings tab.

Note that if you hover your cursor inside the text field, a popup displays the substitutions used in the launch string.

After selecting a host, MemoryScape displays all of the processes running on that host. Select the process to which MemoryScape will attach.

These fields are populated with any selected process. Alternatively, you can browse to and select a process using the Browse button here, or enter a PID number.

This workflow shows how many steps are involved in attaching to a file and where you are in this process.

IYou can searching for files specifically or enter terms to filter by, using normal shell globbing rules; that is, you can use such characters as asterisks (*) and question marks (?) as wildcard characters. For example, you could type “fo*b?r”. After entering a filter, click the Refresh button to apply the filter against the displayed list of processes.

Opens the currently selected process in TotalView. The TotalView process window will display the current state of that process. You must have a TotalView license available to debug in TotalView.

Be aware that opening the TotalView process window from within MemoryScape does not initialize TotalView in the same way as starting TotalView directly. The definitions in your .tvdrc file and your saved breakpoints are not loaded. However, you can load a breakpoint file using the Action Point menu item in the process window. If you need the definitions in your .tvdrc file, start TotalView first and open MemoryScape from within TotalView.

Tells MemoryScape to set the Red Zones option on or off for the selected processes.

Launches the Add Username dialog so you can add another user to see his processes and attach to them. If you wish to attach to a process owned by someone else, you need the proper permissions.

If the username is not recognized, the system returns an error; otherwise, the user is added to the User drop-down and selected as the current user.

The selected user’s processes are displayed. Attach to another user’s processes just by clicking the process and selecting Start Session.