OpenCores
URL https://opencores.org/ocsvn/or1k/or1k/trunk

Subversion Repositories or1k

[/] [or1k/] [trunk/] [insight/] [gdb/] [gdbtcl/] [help/] [memory.html] - Blame information for rev 1767

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 578 markom
<!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
   <META NAME="GENERATOR" CONTENT="Mozilla/4.06 [en] (X11; I; Linux 2.0.35 i686) [Netscape]">
6
   <TITLE>Memory Window Help</TITLE>
7
</HEAD>
8
<BODY>
9
 
10
<H1>
11
The Memory Window</H1>
12
The Memory Window allows users to display and edit the contents of memory.
13
The Memory Window Preferences controls all of the display characteristics
14
of the Memory Window.
15
<BR>&nbsp;
16
<LI>
17
<A HREF="#menus">Address Menu</A></LI>
18
 
19
<LI>
20
<A HREF="#display">Memory Display</A></LI>
21
 
22
<LI>
23
<A HREF="#prefs">Memory Window Preferences</A></LI>
24
 
25
<H2>
26
 
27
<HR WIDTH="100%"></H2>
28
 
29
<H2>
30
<A NAME="menus"></A>Address Menu</H2>
31
<IMG SRC="images/mem_menu.gif" HEIGHT=66 WIDTH=160>
32
<P>This pulldown menu contains the following three items.
33
<DL>
34
<DT>
35
<A NAME="menus_auto"></A>Auto Update</DT>
36
 
37
<DD>
38
When selected, causes the Memory Window to update the display every.&nbsp;
39
If it is not selected, the display will be frozen until it is selected
40
or "Update Now" is selected.</DD>
41
 
42
<DT>
43
<A NAME="menus_now"></A>Update Now</DT>
44
 
45
<DD>
46
Forces the Memory Window to update the display immediately.</DD>
47
 
48
<DT>
49
<A NAME="menus_prefs"></A>Preferences</DT>
50
 
51
<DD>
52
Opens the <A HREF="#prefs">Memory Window Preferences</A> dialog.</DD>
53
</DL>
54
 
55
<H2>
56
 
57
<HR WIDTH="100%"></H2>
58
 
59
<H2>
60
<A NAME="display"></A>Memory Display</H2>
61
Like the <A HREF="register.html">Register Window</A>, the Memory Window
62
display is organized into a spreadsheet. The address of any cell in the
63
Display can be determined by appending the row and column headers for the
64
cell. Optionally, an ASCII display of the memory appears at the right.
65
Any non-ASCII-representable byte in memory will appear in the ASCII Display
66
as a control character (a dot, ".", by default). The <A HREF="#pref">Memory
67
Preferences Dialog</A> may be used to alter the appearance of the Memory
68
Window.
69
<P><A NAME="display_nav"></A>To navigate the Memory Window, use the mouse
70
and click the cell of interest. As an alternative, pressing the arrow keys
71
on the keyboard will focus successive cells, from left to right, top to
72
bottom. The focus will wrap from left to right, so hitting the right arrow
73
key will keep advancing the address of the cell selected.
74
<H4>
75
<A NAME="display_edit"></A>Editing Memory</H4>
76
To edit memory, simply enter the new value of the memory into the cell
77
and press the enter key on the keyboard. As with the
78
<A HREF="register.html">Register
79
Window</A>, be careful of the input format used to enter data -- the debugger
80
is capable of parsing binary, octal, decimal, and hexadecimal values. All
81
entries will be padded with leading zeroes, if necessary.&nbsp; After you
82
hit enter, the memory window will automatically shift focus to the next
83
cell.
84
<P>To edit part of the value of a cell, you can use the mouse to poistion
85
the cursor to the exact part of the value you want to change.&nbsp; You
86
can also use the backspace key to delete part of the value without deleting
87
the whole value.
88
<P>Another way to edit memory is to edit the ASCII window.&nbsp; To do
89
this, select a cell using the mouse.&nbsp; Then type in a new string.
90
<H4>
91
<A NAME="display_popup"></A>Memory Pop-up Menu</H4>
92
Clicking the right mouse button while the mouse cursor lies within the
93
bounds of any cell brings up the following menu:
94
<P><IMG SRC="images/mem_popup.gif" HEIGHT=100 WIDTH=220>
95
<DL>
96
<DT>
97
Auto Update</DT>
98
 
99
<DL>
100
<DT>
101
When selected, the Memory Window will track changes in memory shown in
102
the Display.&nbsp; When not selected, the Memory Window is "frozen", representing
103
a "snapshot" of memory.</DT>
104
</DL>
105
 
106
<DT>
107
Update Now</DT>
108
 
109
<DL>
110
<DT>
111
&nbsp;Forces the Memory Window to update the display immediately.</DT>
112
</DL>
113
 
114
<DT>
115
Go To <I>address</I></DT>
116
 
117
<DD>
118
The Memory Window Display is updated to show memory starting at address
119
<I>address</I>.</DD>
120
 
121
<DT>
122
Open New Window at <I>address</I></DT>
123
 
124
<DD>
125
A new Memory Window is opened, displaying memory at address <I>address</I></DD>
126
 
127
<DT>
128
Preferences...</DT>
129
 
130
<DD>
131
Opens the Memory Window Preferences for editing the appearance of the Memory
132
Window Display.</DD>
133
</DL>
134
 
135
<H2>
136
 
137
<HR WIDTH="100%"></H2>
138
 
139
<H2>
140
<A NAME="prefs"></A>Memory Window Preferences</H2>
141
Memory Window Preference Dialog governs the appearance of the Memory Window:
142
the total number of bytes displayed, the size of each cell, ASCII control
143
character.
144
<P><IMG SRC="images/mem_pref.gif" HEIGHT=417 WIDTH=330>
145
<H4>
146
<A NAME="prefs_size"></A>Size of the Display Cells</H4>
147
This attribute controls how many bytes appear in each cell. Valid cell
148
sizes in the Memory Window may be:
149
<DL>
150
<DT>
151
Byte</DT>
152
 
153
<DD>
154
Each cell is exactly one byte</DD>
155
 
156
<DT>
157
Half Word</DT>
158
 
159
<DD>
160
Cells are displayed with two bytes</DD>
161
 
162
<DT>
163
Word</DT>
164
 
165
<DD>
166
Each cell contains four bytes</DD>
167
 
168
<DT>
169
Double Word</DT>
170
 
171
<DD>
172
Cells contain eight bytes</DD>
173
 
174
<DT>
175
Float</DT>
176
 
177
<DD>
178
Each cell contains four bytes, displayed as a floating point number</DD>
179
 
180
<DT>
181
Double Float</DT>
182
 
183
<DD>
184
Cells are displayed as floating point, eight bytes each</DD>
185
</DL>
186
 
187
<H4>
188
<A NAME="prefs_fmt"></A>Format of the Display Cells</H4>
189
The Format option of the Memory Preferences Dialog governs how the debugger
190
represents the memory. Possible representations include:
191
<DL>
192
<DT>
193
Binary</DT>
194
 
195
<DD>
196
The values are shown as binary numbers</DD>
197
 
198
<DT>
199
Signed Decimal</DT>
200
 
201
<DD>
202
The values are shown as signed decimal numbers</DD>
203
 
204
<DT>
205
Octal</DT>
206
 
207
<DD>
208
Each cell is represented as an octal number</DD>
209
 
210
<DT>
211
Unsigned Decimal</DT>
212
 
213
<DD>
214
Values are displayed as unsigned decimals</DD>
215
 
216
<DT>
217
Hex</DT>
218
 
219
<DD>
220
Memory is displayed as a hexadecimal number. This is the default.</DD>
221
</DL>
222
 
223
<H4>
224
<A NAME="prefs_bytes"></A>Size of the Memory Window</H4>
225
The size of the memory window determines how much memory is actually presented
226
to the user. The total number of bytes shown can either be determined by
227
the size of the window, in which case resizing the Memory Window will cause
228
more or less memory to be displayed, or fixed at some specified number
229
of bytes. By default, the Memory Window shows 128 bytes of memory.
230
<H4>
231
<A NAME="prefs_misc"></A>Miscellaneous</H4>
232
Miscellaneous memory preferences include the option to display the ASCII
233
representation of the memory, including what character to use for non-ASCII
234
bytes (the "control" character). Additionally, users may specify the number
235
of bytes per row, either four, eight, sixteen, or thirty-two. The default
236
is sixteen bytes per row.
237
</BODY>
238
</HTML>

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.