Skip to main content
summaryrefslogblamecommitdiffstats
blob: 2341fe8431584c8333617314ffb8a9a15bc347cf (plain) (tree)
1
2
3
4
5
6
7
8
9
10
11

                                                       
 







                                                                   


                    
 
                                      



                                                                                   
                                                                                

                                                                               
                                                                     







                                                                                   

























































                                                                                                                               

     



























































































                                                                                                                                                                                     








                                                                                                 

                                                                 

       
       
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html lang="en">
 
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Memory view</title>
<link rel="stylesheet" type="text/css" href="../help.css">
</head>
<body>

<h1>Memory view</h1>

<p>The <b>Memory</b> view of the Debug
perspective lets you monitor and modify your process memory. The process memory
is presented as a list of so called <b>memory monitors</b>. Each monitor represents
a section of memory specified by it's location called <b>base address</b>. Each
memory monitor can be displayed in different predefined data formats -- <b>memory
renderings</b>. The debugger supports five rendering types -- <b>hexadecimal</b>
(default), <b>ascii</b>, <b>signed integer</b> and <b>unsigned integer</b>. The
default rendering is displayed automatically on the monitor creation.</p>
<p><img src="../images/view_memory.png" width="718" height="235"></p>
<p>The Memory view contains two
panes -- the <b>Memory Monitors</b> pane and the <b>Memory Renderings</b> pane. The
Memory Monitors pane displays the list of memory monitors added to the debug
session currently selected in the Debug view. The content of the Memory
Renderings pane is controlled by the selection in the Memory Monitors pane and
consists of the tabs that display renderings. The Memory Renderings pane can be
configured to display two renderings simultaneously.</p>

<dl><h3>Memory view toolbar icons</h3>
<p>The table below lists the icons displayed in the Memory view toolbar.</p>
<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
  <tr>
    <td width="16%" align="left"><div align="center"><b>Command</b></div></td>
    <td width="32%"><div align="center"><b>Name</b></div></td>
    <td width="52%"><div align="center"><b>Description</b></div></td>
  </tr>
  <tr>
    <td valign="top"><div align="center"><img src="../images/icon_new_memory_view.png" width="22" height="21"></div></td>
    <td valign="top"><div align="left">New Memory View </div></td>
    <td valign="top">Click to create a new memory view.</td>
  </tr>
  <tr>
    <td valign="top"><div align="center"><img src="../images/icon_pin_memory.png" width="21" height="21"></div></td>
    <td valign="top"><div align="left">Pin Memory Monitor </div></td>
    <td valign="top">Select to pin the memory monitor on top of all other memory monitors. </td>
  </tr>
  <tr>
    <td valign="top"><div align="center"><img src="../images/icon_toggle_memory_monitor.png" width="22" height="21"></div></td>
    <td valign="top"><div align="left">Toggle Memory Monitors Pane </div></td>
    <td valign="top">Shows/hides the Memory Monitor pane.</td>
  </tr>
  <tr>
    <td valign="top"><div align="center"><img src="../images/icon_toggle_split_pane.png" width="23" height="21"></div></td>
    <td valign="top"><div align="left">Toggle Split Pane </div></td>
    <td valign="top">Toggles the Memory Renderings pane split.</td>
  </tr>
  <tr>
    <td valign="top"><div align="center"><img src="../images/icon_link_mem_rendering.png" width="22" height="22"></div></td>
    <td valign="top"><div align="left">Link Memory Rendering Panes </div></td>
    <td valign="top">Synchronizes the selection of two memory renderings.</td>
  </tr>
  <tr>
    <td valign="top"><div align="center"><img src="../images/icon_switch_mem_monitor.png" width="33" height="20"></div></td>
    <td valign="top"><div align="left">Switch Memory Monitor </div></td>
    <td valign="top">When more than one memory monitor is active, select a different memory monitor to view. </td>
  </tr>
  <tr>
    <td valign="top">&nbsp;</td>
    <td valign="top">Menu &gt; Layout </td>
    <td valign="top">Switch  the Monitors and Rendering panes display between horizontal or vertical orientation. </td>
  </tr>
  <tr>
    <td valign="top">&nbsp;</td>
    <td valign="top">Menu &gt; Preferences </td>
    <td valign="top"><p>Opens the Preferences window allowing you to set:</p>
      <ul>
	  <li><b>Reset Memory Monitor</b> - set to reset only visible or all renderings when reseting a memory monitor </li>
	  <li><b>Padded String</b> - enter strings to show unretrievable memory </li>
	  <li><b>Select Codepages</b> - specify the standard to convert memory to ASCII and EBCDIC strings </li>
    </ul>  </tr>
  <tr>
    <td valign="top">&nbsp;</td>
    <td valign="top">Menu &gt; Table Rendering Preferences </td>
    <td valign="top">Specify the memory loading mode to use when rendering scrolls to the end of the buffer. </td>
  </tr>
</table>
</dl>

<dl>
  <h3>Monitors pane context menu </h3>
  <p>The Monitors pane context menu inside the Memory view  includes:</p>
  <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
    <tr>
      <td width="19%" align="left"><div align="center"><b>Command</b></div></td>
      <td width="35%"><div align="center"><b>Name</b></div></td>
      <td width="46%"><div align="center"><b>Description</b></div></td>
    </tr>
    <tr>
      <td valign="top"><div align="center"><img src="../images/icon_add_mem_monitor.png" width="18" height="18"></div></td>
      <td valign="top"><div align="left">Add Memory Monitor </div></td>
      <td valign="top">Adds a new memory address or variable to the Memory Monitors pane.</td>
    </tr>
    <tr>
      <td valign="top"><div align="center"><img src="../images/icon_remove.png" width="22" height="22"></div></td>
      <td valign="top"><div align="left">Remove Memory Monitor </div></td>
      <td valign="top">Removes the selected memory address or variable from the Memory Monitors pane.</td>
    </tr>
    <tr>
      <td valign="top"><div align="center"><img src="../images/icon_reset_mem_monitor.png" width="24" height="22"></div></td>
      <td valign="top"><div align="left">Reset </div></td>
      <td valign="top">Resets the current memory monitor  view. </td>
    </tr>
  </table>
</dl>
<dl>
  <h3>Rendering pane context menu </h3>
  <p>The Rendering pane context menu inside the Memory view  includes:</p>
  <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
    <tr>
      <td width="19%" align="left"><div align="center"><b>Command</b></div></td>
      <td width="35%"><div align="center"><b>Name</b></div></td>
      <td width="46%"><div align="center"><b>Description</b></div></td>
    </tr>
    <tr>
      <td valign="top"><div align="center"><img src="../images/icon_add_mem_monitor.png" width="18" height="18"></div></td>
      <td valign="top"><div align="left">Add Rendering </div></td>
      <td valign="top">Add a memory rendering pane to display a memory monitor item at a different address or in a different format.</td>
    </tr>
    <tr>
      <td valign="top"><div align="center"><img src="../images/icon_remove.png" width="22" height="22"></div></td>
      <td valign="top"><div align="left">Remove Rendering </div></td>
      <td valign="top">Removes the selected rendering from the Memory view.</td>
    </tr>
    <tr>
      <td valign="top">&nbsp;</td>
      <td valign="top">Panes</td>
      <td valign="top">Enable or disable the showing of the Address, Binary, and Text portions of the rendering view. </td>
    </tr>
    <tr>
      <td valign="top">&nbsp;</td>
      <td valign="top">Endian</td>
      <td valign="top">Toggle between the Little (default) and Big   Endian display of memory. </td>
    </tr>
    <tr>
      <td valign="top">&nbsp;</td>
      <td valign="top">Text</td>
      <td valign="top">Choose the character encoding used to convert memory values into text for display. Choices include: ISO-8859-1 (default), US-ASCII, or UTF-8. </td>
    </tr>
    <tr>
      <td valign="top">&nbsp;</td>
      <td valign="top">Cell Size </td>
      <td valign="top">Specify the cell size used to display values in the Binary column. Choices include: 1, 2, 4 (default), and 8 bytes. </td>
    </tr>
    <tr>
      <td valign="top">&nbsp;</td>
      <td valign="top">Radix</td>
      <td valign="top">Specify the radix used to display the  values in the Binary column. Choices include: Hex, Decimal Signed, Decimal Unsigned (default), Octal, and Binary. </td>
    </tr>
    <tr>
      <td valign="top"><div align="center"><img src="../images/icon_copy_to_clipboard.png" width="22" height="23"></div></td>
      <td valign="top">Copy To Clipboard </td>
      <td valign="top">Copies the selected portion of the Rendering pane to the clipboard. </td>
    </tr>
    <tr>
      <td valign="top">&nbsp;</td>
      <td valign="top">Go To Address </td>
      <td valign="top">Opens an edit box to type in a memory address. Press Enter to go to that address and show it in the Rendering pane. </td>
    </tr>
    <tr>
      <td valign="top">&nbsp;</td>
      <td valign="top">Reset To Base Address </td>
      <td valign="top">Resets the Rendering pane to the original base address. </td>
    </tr>
    <tr>
      <td valign="top"><div align="center"></div></td>
      <td valign="top"><div align="left">Refresh</div></td>
      <td valign="top">Refreshes the Rendering pane. </td>
    </tr>
  </table>
</dl>
<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
<br>
<a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p>
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
<br>
<a href="../tasks/cdt_t_memory.htm">Working with memory</a></p>
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
<br>
<a href="cdt_o_views.htm">Views</a></p>
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >

</body>

</html>

Back to the top