Memory Analysis Session View

Manage memory analysis sessions

Description:

The Session view lets you manage your memory analysis sessions. You can load these sessions into the Memory Analysis perspective, so you can search for memory management errors in your application.

The view lists all of the memory analysis sessions that you've created in your workspace while running programs with the Memory Analysis tool active. Each session is identified by a name, date stamp, and an icon that indicates its current state.

The icons indicate:

This memory analysis session is open and can be viewed in the Memory Analysis editor.

This session is closed and cannot currently be viewed.

This session is still running on the target; you can select the session and view its incoming traces.

---

If the session is running, you may need to close and reopen the tabs at the top of the editor periodically to refresh the information in the Errors and Statistics panes.

---

The traces and events are being indexed. This icon appears only if you stop the memory analysis session or your process terminates. If your process terminates, the running icon may still be displayed while the database is registering the events and traces; when this is done, the indexing icon appears. Wait until indexing is finished, or the information might be incomplete.

Right-clicking on a connected session () displays a menu with several options:

• View
• Disconnect
• Import libmalloc_g events
• Delete
• Rename
• Properties

Right-clicking on a disconnected session () displays a menu with several options:

• Connect
• Import libmalloc_g events
• Delete
• Rename
• Properties

Connecting to a session

Memory analysis sessions must be "connected" before they can be viewed in the Memory Analysis editor. To connect a session:

1. Right-click the session in the Session view.
2. Choose Connect from the pop-up menu.

After a moment, the session is connected ().

Deleting a session

To delete a session:

1. Right-click the session in the Session view.
2. Choose Delete from the pop-up menu.

The IDE deletes the memory analysis session.

Disconnecting from a session

To disconnect a session and recover the resources it uses while connected:

1. Right-click the session in the Session view.
2. Choose Disconnect from the pop-up menu.

After a moment, the session is disconnected ().

Displaying information about a session

To view information about a session:

1. Right-click the session in the Session view.
2. Choose Properties from the pop-up menu.

The IDE displays a Properties dialog for that memory analysis session:

Filtering information for a session

Occasionally, there may be too much information in a Memory Analysis session, and you might want to filter some of this information to narrow down your search for memory errors, events, and traces.

To filter out Memory Analysis session information:

1. Expand your Memory Analysis session in the session view.
2. Select specific session components, such as library and/or thread, that you want to filter on. You can double-click any of the session components to open a corresponding Memory Analysis Allocations pane containing memory events and traces that belong to the selected component.

Renaming a session

To rename a memory analysis session:

1. Right-click the session in the Session view.
2. Choose Rename from the pop-up menu.

   The IDE displays the Rename Session dialog.

   

3. Enter a new name for the session, then click OK to change the session's name. Click Cancel to leave the name unchanged.

Viewing a session

The IDE opens the memory analysis session in the Memory Analysis editor.

Import libmalloc_g events

You'll use this item after you've logged trace events to a file on the target system and copied the file to your host system. For more information, see "Using a file to log the trace" in the Finding Memory Errors chapter.