| 1 |
578 |
markom |
<HTML>
|
| 2 |
|
|
<HEAD>
|
| 3 |
|
|
<TITLE>Memory Window Help</TITLE>
|
| 4 |
|
|
</HEAD>
|
| 5 |
|
|
<BODY>
|
| 6 |
|
|
<H1>The Memory Window</H1>
|
| 7 |
|
|
<H2>Overview</H2>
|
| 8 |
|
|
<P>The Memory Window allows users to display the contents of collected
|
| 9 |
|
|
memory. The Memory Window Preferences controls all of the display
|
| 10 |
|
|
characteristics of the Memory Window.</P>
|
| 11 |
|
|
|
| 12 |
|
|
<P>Memory Window topics:
|
| 13 |
|
|
<UL>
|
| 14 |
|
|
<LI><UL><A HREF="#menus">Address Menu</A>
|
| 15 |
|
|
<LI><A HREF="#menus_auto">Auto Update</A>
|
| 16 |
|
|
<LI><A HREF="#menus_now">Update Now</A>
|
| 17 |
|
|
<LI><A HREF="#menus_prefs">Preferences</A>
|
| 18 |
|
|
</UL>
|
| 19 |
|
|
<LI><UL><A HREF="#display">Memory Display</A>
|
| 20 |
|
|
<LI><A HREF="#display_nav">Navigating the Memory Window</A>
|
| 21 |
|
|
<LI><A HREF="#display_popup">Memory Pop-up Menu</A>
|
| 22 |
|
|
</UL>
|
| 23 |
|
|
<LI><UL><A HREF="#prefs">Memory Window Preferences</A>
|
| 24 |
|
|
<LI><A HREF="#prefs_size">Size of the Display Cell</A>
|
| 25 |
|
|
<LI><A HREF="#prefs_fmt">Format of the Display Cell</A>
|
| 26 |
|
|
<LI><A HREF="#prefs_bytes">Size of the Memory Window</A>
|
| 27 |
|
|
<LI><A HREF="#prefs_misc">Miscellaneous</A>
|
| 28 |
|
|
</UL>
|
| 29 |
|
|
</UL></P>
|
| 30 |
|
|
|
| 31 |
|
|
<H3><A NAME="menus">Address Menu</A></H3>
|
| 32 |
|
|
<DL>
|
| 33 |
|
|
<DT><A NAME="menus_auto">Auto Update</A>
|
| 34 |
|
|
<DD>When selected, casues the Memory Window to update the Display.
|
| 35 |
|
|
<DT><A NAME="menus_now">Update Now</A>
|
| 36 |
|
|
<DD>Forces the Memory Window to update the Display.
|
| 37 |
|
|
<DT><A NAME="menus_prefs">Preferences</A>
|
| 38 |
|
|
<DD>Opens the Memory Window Preferences dialog.
|
| 39 |
|
|
</DL>
|
| 40 |
|
|
|
| 41 |
|
|
<H3><A NAME="display">Memory Display</A></H3>
|
| 42 |
|
|
Like the <A HREF="register.html">Register Window</A>, the Memory Window
|
| 43 |
|
|
Display is organized into a spreadsheet. The address of any cell in the
|
| 44 |
|
|
Display can be determined by appeding the row and column headers for the
|
| 45 |
|
|
cell. Optionally, an ASCII display of the memory appears at the right.
|
| 46 |
|
|
Any non-ASCII-representable byte in memory will appear in the ASCII Display
|
| 47 |
|
|
as a control character (a dot, ".", by default). The <A HREF="#pref">Memory
|
| 48 |
|
|
Preferences Dialog</A> may be used to alter the appearance of the
|
| 49 |
|
|
Memory Window. Any uncollected memory will appear as "N/A", indicating that
|
| 50 |
|
|
this memory was not collected when the trace experiment was run.
|
| 51 |
|
|
|
| 52 |
|
|
<P><A NAME="display_nav">To navigate the Memory Window</A>, use the mouse
|
| 53 |
|
|
and click the cell of interest. As an alternative, pressing the TAB key on
|
| 54 |
|
|
the keyboard will focus successive cells, from left to right, top to bottom.
|
| 55 |
|
|
The focus will wrap from the bottom of the Display to the top.</P>
|
| 56 |
|
|
<BR>
|
| 57 |
|
|
|
| 58 |
|
|
<H4><A NAME="display_popup">Memory Pop-up Menu</A></H4>
|
| 59 |
|
|
Clicking the right mouse button while the mouse cursor lies within the
|
| 60 |
|
|
bounds of any cell will allow users to:
|
| 61 |
|
|
<DL>
|
| 62 |
|
|
<DT>Auto Update
|
| 63 |
|
|
<DD>When selected, the Memory Window will track changes in
|
| 64 |
|
|
memory shown in the Display. Cells in which changes have
|
| 65 |
|
|
occured will be highlighted. When not selected, the Memory
|
| 66 |
|
|
Window is "frozen", representing a "snapshot" of memory.
|
| 67 |
|
|
<DT>Update Now
|
| 68 |
|
|
<DD>Causes the Memory Window to update all the cells shown.
|
| 69 |
|
|
<DT>Go To <I>address</I>
|
| 70 |
|
|
<DD>The Memory Window Display is updated to show memory starting
|
| 71 |
|
|
at address <I>address</I>.
|
| 72 |
|
|
<DT>Open New Window at <I>address</I>
|
| 73 |
|
|
<DD>A new Memory Window is opened, displaying memory at address
|
| 74 |
|
|
<I>address</I>
|
| 75 |
|
|
<DT>Memory Preferences...
|
| 76 |
|
|
<DD>Opens the Memory Window Preferences for editing the appearance
|
| 77 |
|
|
of the Memory Window Display.
|
| 78 |
|
|
</DL>
|
| 79 |
|
|
<BR>
|
| 80 |
|
|
|
| 81 |
|
|
<H3><A NAME="prefs">Memory Window Preferences</A></H3>
|
| 82 |
|
|
Memory Window Preference Dialog governs the appearance of the Memory Window:
|
| 83 |
|
|
the total number of bytes displayed, the size of each cell, ASCII control
|
| 84 |
|
|
character.
|
| 85 |
|
|
<BR>
|
| 86 |
|
|
|
| 87 |
|
|
<H4><A NAME="prefs_size">Size of the Display Cells</A></H4>
|
| 88 |
|
|
This attribute controls how many bytes appear in each cell. Valid cell
|
| 89 |
|
|
sizes in the Memory Window may be:
|
| 90 |
|
|
<DL>
|
| 91 |
|
|
<DT>Byte
|
| 92 |
|
|
<DD>Each cell is exactly one byte
|
| 93 |
|
|
<DT>Half Word
|
| 94 |
|
|
<DD>Cells are displayed with two bytes
|
| 95 |
|
|
<DT>Word
|
| 96 |
|
|
<DD>Each cell contains four bytes
|
| 97 |
|
|
<DT>Double Word
|
| 98 |
|
|
<DD>Cells contain eight bytes
|
| 99 |
|
|
<DT>Float
|
| 100 |
|
|
<DD>Each cell contains four bytes, displayed as a floating point
|
| 101 |
|
|
number
|
| 102 |
|
|
<DT>Double Float
|
| 103 |
|
|
<DD>Cells are displayed as floating point, eight bytes each
|
| 104 |
|
|
</DL>
|
| 105 |
|
|
<BR>
|
| 106 |
|
|
|
| 107 |
|
|
<H4><A NAME="prefs_fmt">Format of the Display Cells</A></H4>
|
| 108 |
|
|
The Format option of the Memory Preferences Dialog governs how the debugger
|
| 109 |
|
|
represents the memory. Possible representations include:
|
| 110 |
|
|
|
| 111 |
|
|
<DL>
|
| 112 |
|
|
<DT>Binary
|
| 113 |
|
|
<DD>The values are shown as binary numbers
|
| 114 |
|
|
<DT>Signed Decimal
|
| 115 |
|
|
<DD>The values are shown as signed decimal numbers
|
| 116 |
|
|
<DT>Octal
|
| 117 |
|
|
<DD>Each cell is represented as an octal number
|
| 118 |
|
|
<DT>Unsigned Decimal
|
| 119 |
|
|
<DD>Values are displayed as unsigned decimals
|
| 120 |
|
|
<DT>Hex
|
| 121 |
|
|
<DD>Memory is displayed as a hexadecimal number. This is
|
| 122 |
|
|
the default.
|
| 123 |
|
|
</DL>
|
| 124 |
|
|
<BR>
|
| 125 |
|
|
|
| 126 |
|
|
<H4><A NAME="prefs_bytes">Size of the Memory Window</A></H4>
|
| 127 |
|
|
The size of the memory window determines how much memory is actually
|
| 128 |
|
|
presented to the user. The total number of bytes shown can either be
|
| 129 |
|
|
determined by the size of the window, in which case resizing the Memory
|
| 130 |
|
|
Window will cause more or less memory to be displayed, or fixed at some
|
| 131 |
|
|
specified number of bytes. By default, the Memory Window shows 128 bytes
|
| 132 |
|
|
of memory.
|
| 133 |
|
|
<BR>
|
| 134 |
|
|
|
| 135 |
|
|
<H4><A NAME="prefs_misc">Miscellaneous</A></H4>
|
| 136 |
|
|
Miscellaneous memory preferences include the option to display the ASCII
|
| 137 |
|
|
representation of the memory, including what character to use for non-ASCII
|
| 138 |
|
|
bytes (the "control" character). Additionally, users may specify the number
|
| 139 |
|
|
of bytes per row, either four, eight, sixteen, or thirty-two. The default is
|
| 140 |
|
|
sixteen bytes per row.
|
| 141 |
|
|
</BODY>
|
| 142 |
|
|
</HTML>
|
