|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 1.0 Transitional//EN"> |
|
2 <html> |
|
3 <head> |
|
4 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> |
|
5 <title>Viewing AnalyzeTool memory activity graphs</title> |
|
6 <link href="../nokia.css" type="text/css" rel="StyleSheet"> |
|
7 </head> |
|
8 <body> |
|
9 |
|
10 <h2>Viewing memory activity graph</h2> |
|
11 <p>Memory activity graphs are generated automatically after the data capturing is stopped. Alternatively, an existing trace file can be opened to view memory activity graphs. For more information, see <a href="..\concepts\datafile.htm">AnalyzeTool files</a>.</p> |
|
12 <p>There are two options for opening a memory analysis data file:</p> |
|
13 <ul> |
|
14 <li>From the <b>Project pop-up</b> menu, select <b>AnalyzeTool</b> > <b>Open and analyze data file</b>.</li> |
|
15 <li>In the <b>AnalyzeTool</b> view, click the <b>Open and analyze data file</b> button.</li> |
|
16 </ul> |
|
17 <p>Memory activity graphs are displayed in the <b>AnalyzeTool</b> window on the <b>Graph</b> tab. After the data has loaded, select a process in the <b>Process</b> drop down box to view its memory activity. </p> |
|
18 <p><img src="../images/sample_graph.png" alt="AnalyzeTool graph tab"></p> |
|
19 |
|
20 <h3>Description of graph</h3> |
|
21 <p>The graph shows the cumulative memory of the given process over time. |
|
22 Each memory operation is marked with a dot on the graph as follows: |
|
23 <ul> |
|
24 <li><font color="blue">Alloc</font>: A memory allocation is marked in blue if it is freed during the lifetime of the process.</li> |
|
25 <li><font color="red">Leak</font>: A memory allocation is marked in red with a vertical line going down if it is not freed during the lifetime of the process (also known as <em>leak</em>).</li> |
|
26 <li><font color="green">Free</font>: A memory free is marked in green.</li> |
|
27 </ul> |
|
28 <p>Hovering the mouse over a memory operation shows a tooltip with relevant information. |
|
29 A memory operation can also be selected with a mouse click. This will highlight the memory operation on the graph, and |
|
30 more detailed information is shown in the Eclipse Properties view. The Eclipse Properties view may include callstack information if available. |
|
31 <p><b>Tip</b>: Use the <b>arrow left</b> and <b>arrow right</b> keys to move to the next or previous memory operation.</p> |
|
32 <p>When a memory operation is selected, related memory operations are highlighted on the graph. For example, when an alloc is selected, its associated free memory is marked on the graph with a green line going down.</p> |
|
33 |
|
34 <h3>Navigating the graph</h3> |
|
35 <ul> |
|
36 <li><b>Zoom in:</b> Select a region in the graph with your mouse (click the left edge and drag to the right edge of the region to be zoomed in).</li> |
|
37 <li><b>Zoom out:</b> Right-click with the mouse.</li> |
|
38 <li><b>Scroll:</b> Use the scroll bar. Alternatively, select a memory operation with your mouse and use the <b>arrow right</b> or <b>arrow left</b> keys to bring the next or previous into view.</li> |
|
39 </ul> |
|
40 |
|
41 <h3>The Eclipse Properties View</h3> |
|
42 <p>When a single memory allocation is selected on the graph, the Eclipse Properties view shows detailed information about the memory operation. |
|
43 If the Eclipse Properties view is not already open, it can be opened by selecting <b>Windows</b> > <b>Show View</b> > <b>Properties</b>. |
|
44 </p> |
|
45 <img src="../images/properties_view.png" alt="AnalyzeTool Properties View"> |
|
46 <p>Double-clicking an item in the callstack opens the appropriate source code file to that code line, provided the source code file can be found in the selected project in Carbide.c++.</p> |
|
47 |
|
48 |
|
49 <div id="footer">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. |
|
50 License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div> |
|
51 </body> |
|
52 </html> |