sysperfana/memspyext/com.nokia.s60tools.memspy.help/html/reference/cell_type.htm
changeset 7 8e12a575a9b5
equal deleted inserted replaced
6:f65f740e69f9 7:8e12a575a9b5
       
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
       
     2 <html>
       
     3 <head>
       
     4   <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
       
     5   <title>Cell Type</title>
       
     6   <link href="../../book.css" type="text/css" rel="stylesheet">
       
     7 </head>
       
     8 
       
     9 <body>
       
    10 <h2>Cell Type</h2>
       
    11 
       
    12 <p>The Cell Type view is a low-level view of the layout of the heap. It is
       
    13 useful for getting a quick feel for fragmentation, for example, but the other
       
    14 views are more commonly used.</p>
       
    15 
       
    16 <p><img src="../images/ha_heap_view.png"></p>
       
    17 
       
    18 <p>The Cell Type view breaks down the heap into word-sized (4 byte) blocks,
       
    19 each represented by a coloured square. The following colour-coding is applied
       
    20 to each related group of words for easy identification:</p>
       
    21 <ul>
       
    22   <li><strong>White</strong>: Contains a header word, used by the heap
       
    23     allocator for book-keeping.</li>
       
    24   <li><strong>Red/Orange</strong>: Contains the data of an allocated object
       
    25     whose class has been identified via its vtable pointer.</li>
       
    26   <li><strong>Yellow</strong>: Contains the data of a heap-allocated
       
    27   descriptor.</li>
       
    28   <li><strong>Purple/Brown</strong>: Contains the data of an allocated object
       
    29     whose type cannot be identified, usually a raw data buffer.</li>
       
    30   <li><strong>Blue</strong>: A free area of the heap that does not currently
       
    31     contain an allocated object.</li>
       
    32 </ul>
       
    33 
       
    34 <p>The colour fade between the start and end of a group of words makes it
       
    35 easier for you to pick out the beginning and the end of cells.</p>
       
    36 
       
    37 <p>If you highlight a cell by hovering the mouse over it (the whole of the
       
    38 associated cell is highlighted), you get a pop-up summary of its contents as a
       
    39 tool-tip. You can also right-click to bring up a context menu of options.</p>
       
    40 
       
    41 <p>If you click on a cell to select it, or navigate to it using the cursor keys
       
    42 or the <strong>Previous / Next</strong> buttons, or search for it by address in
       
    43 the <strong>Search</strong> box, then that cell will be selected and you will
       
    44 get a summary in the <strong>Information</strong> box below.</p>
       
    45 <ul>
       
    46   <li><strong>Address</strong> is the start of the cell, including book-keeping
       
    47     info.</li>
       
    48   <li><strong>Payload</strong> is the address range of the actual data stored
       
    49     in the cell.</li>
       
    50   <li><strong>Nesting level</strong> and <strong>Allocation number</strong>
       
    51     info for a cell are only maintained by the debug (UDEB) version of RHeap,
       
    52     and rarely used as a result.</li>
       
    53 </ul>
       
    54 
       
    55 <p>If you double-click on a cell, a floating memory inspector window will be
       
    56 displayed, showing you the cell contents. Cells that contain references to
       
    57 other memory locations are highlighted. Double-clicking a highlighted value
       
    58 jumps to the referenced location.</p>
       
    59 
       
    60 <h5>Related references</h5>
       
    61 <ul>
       
    62   <li><a href="object_type.htm">Object Type</a></li>
       
    63   <li><a href="parent_binary.htm">Parent Binary</a></li>
       
    64   <li><a href="cell_lenght.htm">Cell Lenght</a></li>
       
    65   <li><a href="isolation.htm">Isolation and Pervasiveness</a></li>
       
    66   <li><a href="HA_data_analysis.htm">Data analysis with Heap Analyser</a></li>
       
    67 </ul>
       
    68 
       
    69 <div id="footer">
       
    70 Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights
       
    71 reserved. License: <a
       
    72 href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div>
       
    73 </body>
       
    74 </html>