|
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> |