|
5
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
|
2 |
<html lang="en">
|
|
|
3 |
|
|
|
4 |
<head>
|
|
|
5 |
<meta http-equiv="Content-Language" content="en-us">
|
|
|
6 |
<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
|
|
|
7 |
<meta name="ProgId" content="FrontPage.Editor.Document">
|
|
|
8 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
|
9 |
<title>Memory view</title>
|
|
|
10 |
<link rel="stylesheet" type="text/css" href="../help.css">
|
|
|
11 |
</head>
|
|
|
12 |
<body>
|
|
|
13 |
|
|
|
14 |
<h1>Memory view</h1>
|
|
|
15 |
|
|
|
16 |
<p>The <b>Memory</b> view of the Debug
|
|
|
17 |
perspective lets you monitor and modify your process memory. The process memory
|
|
|
18 |
is presented as a list of so called <b>memory monitors</b>. Each monitor represents
|
|
|
19 |
a section of memory specified by it's location called <b>base address</b>. Each
|
|
|
20 |
memory monitor can be displayed in different predefined data formats -- <b>memory
|
|
|
21 |
renderings</b>. The debugger supports five rendering types -- <b>hexadecimal</b>
|
|
|
22 |
(default), <b>ascii</b>, <b>signed integer</b> and <b>unsigned integer</b>. The
|
|
|
23 |
default rendering is displayed automatically on the monitor creation.</p>
|
|
|
24 |
<p><img src="../images/view_memory.png" width="718" height="235" alt="Memory View"></p>
|
|
|
25 |
<p>The Memory view contains two
|
|
|
26 |
panes -- the <b>Memory Monitors</b> pane and the <b>Memory Renderings</b> pane. The
|
|
|
27 |
Memory Monitors pane displays the list of memory monitors added to the debug
|
|
|
28 |
session currently selected in the Debug view. The content of the Memory
|
|
|
29 |
Renderings pane is controlled by the selection in the Memory Monitors pane and
|
|
|
30 |
consists of the tabs that display renderings. The Memory Renderings pane can be
|
|
|
31 |
configured to display two renderings simultaneously.</p>
|
|
|
32 |
|
|
|
33 |
<h3>Memory view toolbar icons</h3>
|
|
|
34 |
<p>The table below lists the icons displayed in the Memory view toolbar.</p>
|
|
|
35 |
<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
|
|
|
36 |
<tr>
|
|
|
37 |
<td width="16%" align="left"><div align="center"><b>Command</b></div></td>
|
|
|
38 |
<td width="32%"><div align="center"><b>Name</b></div></td>
|
|
|
39 |
<td width="52%"><div align="center"><b>Description</b></div></td>
|
|
|
40 |
</tr>
|
|
|
41 |
<tr>
|
|
|
42 |
<td valign="top"><div align="center"><img src="../images/icon_new_memory_view.png" width="22" height="21" alt="New Memory View icon"></div></td>
|
|
|
43 |
<td valign="top"><div align="left">New Memory View </div></td>
|
|
|
44 |
<td valign="top">Click to create a new memory view.</td>
|
|
|
45 |
</tr>
|
|
|
46 |
<tr>
|
|
|
47 |
<td valign="top"><div align="center"><img src="../images/icon_pin_memory.png" width="21" height="21" alt="Pin Memory Monitor icon"></div></td>
|
|
|
48 |
<td valign="top"><div align="left">Pin Memory Monitor </div></td>
|
|
|
49 |
<td valign="top">Select to pin the memory monitor on top of all other memory monitors. </td>
|
|
|
50 |
</tr>
|
|
|
51 |
<tr>
|
|
|
52 |
<td valign="top"><div align="center"><img src="../images/icon_toggle_memory_monitor.png" width="22" height="21" alt="Toggle Memory Monitors icon"></div></td>
|
|
|
53 |
<td valign="top"><div align="left">Toggle Memory Monitors Pane </div></td>
|
|
|
54 |
<td valign="top">Shows/hides the Memory Monitor pane.</td>
|
|
|
55 |
</tr>
|
|
|
56 |
<tr>
|
|
|
57 |
<td valign="top"><div align="center"><img src="../images/icon_toggle_split_pane.png" width="23" height="21" alt="Toggle Split Pane icon"></div></td>
|
|
|
58 |
<td valign="top"><div align="left">Toggle Split Pane </div></td>
|
|
|
59 |
<td valign="top">Toggles the Memory Renderings pane split.</td>
|
|
|
60 |
</tr>
|
|
|
61 |
<tr>
|
|
|
62 |
<td valign="top"><div align="center"><img src="../images/icon_link_mem_rendering.png" width="22" height="22" alt="Link Memory Rendering Panes icon"></div></td>
|
|
|
63 |
<td valign="top"><div align="left">Link Memory Rendering Panes </div></td>
|
|
|
64 |
<td valign="top">Synchronizes the selection of two memory renderings.</td>
|
|
|
65 |
</tr>
|
|
|
66 |
<tr>
|
|
|
67 |
<td valign="top"><div align="center"><img src="../images/icon_switch_mem_monitor.png" width="33" height="20" alt="Switch Memory Monitor icon"></div></td>
|
|
|
68 |
<td valign="top"><div align="left">Switch Memory Monitor </div></td>
|
|
|
69 |
<td valign="top">When more than one memory monitor is active, select a different memory monitor to view. </td>
|
|
|
70 |
</tr>
|
|
|
71 |
<tr>
|
|
|
72 |
<td valign="top"> </td>
|
|
|
73 |
<td valign="top">Menu > Layout </td>
|
|
|
74 |
<td valign="top">Switch the Monitors and Rendering panes display between horizontal or vertical orientation. </td>
|
|
|
75 |
</tr>
|
|
|
76 |
<tr>
|
|
|
77 |
<td valign="top"> </td>
|
|
|
78 |
<td valign="top">Menu > Preferences </td>
|
|
|
79 |
<td valign="top"><p>Opens the Preferences window allowing you to set:</p>
|
|
|
80 |
<ul>
|
|
|
81 |
<li><b>Reset Memory Monitor</b> - set to reset only visible or all renderings when reseting a memory monitor </li>
|
|
|
82 |
<li><b>Padded String</b> - enter strings to show unretrievable memory </li>
|
|
|
83 |
<li><b>Select Codepages</b> - specify the standard to convert memory to ASCII and EBCDIC strings </li>
|
|
|
84 |
</ul> </tr>
|
|
|
85 |
<tr>
|
|
|
86 |
<td valign="top"> </td>
|
|
|
87 |
<td valign="top">Menu > Table Rendering Preferences </td>
|
|
|
88 |
<td valign="top">Specify the memory loading mode to use when rendering scrolls to the end of the buffer. </td>
|
|
|
89 |
</tr>
|
|
|
90 |
</table>
|
|
|
91 |
|
|
|
92 |
<h3>Monitors pane context menu </h3>
|
|
|
93 |
<p>The Monitors pane context menu inside the Memory view includes:</p>
|
|
|
94 |
<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
|
|
|
95 |
<tr>
|
|
|
96 |
<td width="19%" align="left"><div align="center"><b>Command</b></div></td>
|
|
|
97 |
<td width="35%"><div align="center"><b>Name</b></div></td>
|
|
|
98 |
<td width="46%"><div align="center"><b>Description</b></div></td>
|
|
|
99 |
</tr>
|
|
|
100 |
<tr>
|
|
|
101 |
<td valign="top"><div align="center"><img src="../images/icon_add_mem_monitor.png" width="18" height="18" alt="Add Memory Monitor icon"></div></td>
|
|
|
102 |
<td valign="top"><div align="left">Add Memory Monitor </div></td>
|
|
|
103 |
<td valign="top">Adds a new memory address or variable to the Memory Monitors pane.</td>
|
|
|
104 |
</tr>
|
|
|
105 |
<tr>
|
|
|
106 |
<td valign="top"><div align="center"><img src="../images/icon_remove.png" width="22" height="22" alt="Remote Memory Monitor icon"></div></td>
|
|
|
107 |
<td valign="top"><div align="left">Remove Memory Monitor </div></td>
|
|
|
108 |
<td valign="top">Removes the selected memory address or variable from the Memory Monitors pane.</td>
|
|
|
109 |
</tr>
|
|
|
110 |
<tr>
|
|
|
111 |
<td valign="top"><div align="center"><img src="../images/icon_reset_mem_monitor.png" width="24" height="22" alt="Reset icon"></div></td>
|
|
|
112 |
<td valign="top"><div align="left">Reset </div></td>
|
|
|
113 |
<td valign="top">Resets the current memory monitor view. </td>
|
|
|
114 |
</tr>
|
|
|
115 |
</table>
|
|
|
116 |
|
|
|
117 |
<h3>Rendering pane context menu </h3>
|
|
|
118 |
<p>The Rendering pane context menu inside the Memory view includes:</p>
|
|
|
119 |
<table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#999999" width="600">
|
|
|
120 |
<tr>
|
|
|
121 |
<td width="19%" align="left"><div align="center"><b>Command</b></div></td>
|
|
|
122 |
<td width="35%"><div align="center"><b>Name</b></div></td>
|
|
|
123 |
<td width="46%"><div align="center"><b>Description</b></div></td>
|
|
|
124 |
</tr>
|
|
|
125 |
<tr>
|
|
|
126 |
<td valign="top"><div align="center"><img src="../images/icon_add_mem_monitor.png" width="18" height="18" alt="Add Rendering icon"></div></td>
|
|
|
127 |
<td valign="top"><div align="left">Add Rendering </div></td>
|
|
|
128 |
<td valign="top">Add a memory rendering pane to display a memory monitor item at a different address or in a different format.</td>
|
|
|
129 |
</tr>
|
|
|
130 |
<tr>
|
|
|
131 |
<td valign="top"><div align="center"><img src="../images/icon_remove.png" width="22" height="22" alt="Remote Rendering icon"></div></td>
|
|
|
132 |
<td valign="top"><div align="left">Remove Rendering </div></td>
|
|
|
133 |
<td valign="top">Removes the selected rendering from the Memory view.</td>
|
|
|
134 |
</tr>
|
|
|
135 |
<tr>
|
|
|
136 |
<td valign="top"> </td>
|
|
|
137 |
<td valign="top">Panes</td>
|
|
|
138 |
<td valign="top">Enable or disable the showing of the Address, Binary, and Text portions of the rendering view. </td>
|
|
|
139 |
</tr>
|
|
|
140 |
<tr>
|
|
|
141 |
<td valign="top"> </td>
|
|
|
142 |
<td valign="top">Endian</td>
|
|
|
143 |
<td valign="top">Toggle between the Little (default) and Big Endian display of memory. </td>
|
|
|
144 |
</tr>
|
|
|
145 |
<tr>
|
|
|
146 |
<td valign="top"> </td>
|
|
|
147 |
<td valign="top">Text</td>
|
|
|
148 |
<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>
|
|
|
149 |
</tr>
|
|
|
150 |
<tr>
|
|
|
151 |
<td valign="top"> </td>
|
|
|
152 |
<td valign="top">Cell Size </td>
|
|
|
153 |
<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>
|
|
|
154 |
</tr>
|
|
|
155 |
<tr>
|
|
|
156 |
<td valign="top"> </td>
|
|
|
157 |
<td valign="top">Radix</td>
|
|
|
158 |
<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>
|
|
|
159 |
</tr>
|
|
|
160 |
<tr>
|
|
|
161 |
<td valign="top"><div align="center"><img src="../images/icon_copy_to_clipboard.png" width="22" height="23" alt="Copy to Clipboard icon"></div></td>
|
|
|
162 |
<td valign="top">Copy To Clipboard </td>
|
|
|
163 |
<td valign="top">Copies the selected portion of the Rendering pane to the clipboard. </td>
|
|
|
164 |
</tr>
|
|
|
165 |
<tr>
|
|
|
166 |
<td valign="top"> </td>
|
|
|
167 |
<td valign="top">Go To Address </td>
|
|
|
168 |
<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>
|
|
|
169 |
</tr>
|
|
|
170 |
<tr>
|
|
|
171 |
<td valign="top"> </td>
|
|
|
172 |
<td valign="top">Reset To Base Address </td>
|
|
|
173 |
<td valign="top">Resets the Rendering pane to the original base address. </td>
|
|
|
174 |
</tr>
|
|
|
175 |
<tr>
|
|
|
176 |
<td valign="top"><div align="center"></div></td>
|
|
|
177 |
<td valign="top"><div align="left">Refresh</div></td>
|
|
|
178 |
<td valign="top">Refreshes the Rendering pane. </td>
|
|
|
179 |
</tr>
|
|
|
180 |
</table>
|
|
|
181 |
|
|
|
182 |
<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
|
|
|
183 |
<br>
|
|
|
184 |
<a href="../concepts/cdt_c_dbg_info.htm">Debug information</a></p>
|
|
|
185 |
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
|
|
|
186 |
<br>
|
|
|
187 |
<a href="../tasks/cdt_t_memory.htm">Working with memory</a></p>
|
|
|
188 |
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
|
|
|
189 |
<br>
|
|
|
190 |
<a href="cdt_o_views.htm">Views</a></p>
|
|
|
191 |
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
|
|
|
192 |
|
|
|
193 |
</body>
|
|
|
194 |
|
|
|
195 |
</html>
|