wguidrnt.gml

开放源码的编译器open watcom 1.6.0版的源代码

.ix 'Memory Walk window'
Selecting the View Memory button in the Process Status dialog opens a
Memory Walk window which allows you to view the address space of the
process that caused the exception.
:CMT. .figure *depth='1.xx' *file='DRWx' The Memory Walk window displays a walk of the address space for the process that caused the exception.
.np
The information in this window appears under the following headings:
.begpoint
.point Base
This is the address where this memory object begins.
.point AllocBase
The is the address where the allocation object begins. This tells you
which allocation object a memory object belongs to.
.point Size
This is the size of the memory object.
.point Prot
Codes indicating what you can do with the memory.
The codes are:
.begbull $compact
.bull
RO&mdash.Read Only
.bull
NA&mdash.Not applicable
.bull
ExRO&mdash.Executable and Read Only
.bull
RW&mdash.Read, Write
.bull
WC&mdash.Write, Copy
.bull
Ex&mdash.Executable
.bull
ExRW&mdash.Executable, Read, Write
.bull
ExWC&mdash.Executable, Write, Copy
.endbull
.point State
The state of the memory. Values are:
.begbull $compact
.bull
Free&mdash.range of addresses not being used
.bull
Committed&mdash.range of addresses refers to memory that exists
.bull
Reserved&mdash.this range of addresses has been set aside for future
use but no memory exists for the addresses
.endbull
.point Object
Information indicating what the memory is being used for. This field
is only completed if &drnt can provide useful information.
.point Image
The name of the module that owns the memory object. This field is only
completed if &drnt can provide useful information.
.endpoint
.np
From this window you can select a memory object and view its contents.
To view this information, double click on the desired object. This
opens a Memory Range window for the selected object. This window
displays all of the data stored in the selected object. The data
appears in hexadecimal form. This window allows you to see if the data
in memory is what you believe it should be.
:CMT. .figure *depth='1.xx' *file='DRWx' The Memory Range window displays the data, in hexadecimal form, that is stored in the selected object.
.begnote
.note Note:
You can only view memory for an object whose state is Committed since
there is no memory associated with other objects.
.endnote
.np
There are a number of functions you can perform in the Memory Range
window. Following is a description of these functions.
.*
.beglevel
.*
.section &drnt.: Saving Window Information
.*
.np
.ix 'Save' 'on Memory Range window'
.ix '&drnt' 'save on Memory Range window'
The Save items in the File menu on the Memory Range window allows you
to save the currently displayed information to a text file. Choosing
Save from the File menu on the Memory Range window saves the data in
the window into the current working directory. A message box appears
indicating the path to which &drnt saved the file.
.ix 'Save As' 'on Memory Range window'
.np
Choosing Save As from the File menu allows you to specify the file to
which you want to save the data currently in the window. This opens a
Save As dialog box where you select the desired file. Click on OK when
completed. A message box appears indicating the path to which &drnt
saved the file.
.*
.section &drnt.: Changing the Display
.*
.np
.ix 'Display' 'change in &drnt'
.ix '&drnt' 'change display'
There are three ways to display the information in the Memory Range
window. You can display the information as:
.begbull $compact
.bull
Bytes
.bull
Words
.bull
DWords
.endbull
.np
To change the form of the displayed data, select an item from the
Display menu. When displaying data in bytes, the data appears in the
window as it physically appears in memory. When the data is displayed
as words, the bytes in memory are interpreted for you so that the
values displayed are those that would be obtained by treating the
memory as an array of words. For example, if memory containing the
values:
.millust begin
12 34 56 78 9A BC DE FF
.millust end
was shown as words, the memory window would display:
.millust begin
3412 7856 BC9A FFDE
.millust end
.np
A similar interpretation is performed when the data is displayed as
DWords. If the above memory was shown as DWords, the memory window
would display:
.millust begin
78563412 FFDEBC9A
.millust end
.np
This rearrangement of bytes does not affect the textual interpretation
of the data shown on the right hand side of the window.
.*
.section &drnt.: Setting the Offset
.*
.np
In the Memory Range window you can set the offset. This means that you
can reposition the data so that specific information appears at the
top of the window. The offset you enter appears on the first line. It
will not necessarily be the first piece of information because
rounding often occurs to avoid breaking a line.
.ix 'Set Offset' 'in &drnt'
.ix 'Offset' 'set in &drnt'
.ix '&drnt' 'setting Offset'
.ix 'Memory Range window' 'set offset'
.begstep
.step Choose Set Offset
from the menu bar on the Memory Display window.
.result
This opens a Goto Offset dialog box.
.step Enter the desired offset
that you want to position at the top of the Memory Range window. You
can enter the offset in decimal or hexadecimal form. However, you must
prefix hexadecimal values with 0x.
.step Click on OK.
This closes the dialog and positions the data as requested.
.endstep
.keep 15
.figure *depth='2.26' *scale=100 *file='DRW9' In the Goto Offset dialog, enter the offset you want to appear at the top of the Memory Display window.
.*
.endlevel
.*
.endlevel
.*
.endlevel
.*
.section &drnt.: Working with Log Files
.*
.np
.ix 'Log file'
A log file is a text file created by &drnt.. The log file consists of
entries that describe the state of the system at the time the entry
was made. &drnt gives you the opportunity to create a log file entry
each time an exception occurs. Such entries include information about
the state of the program that caused the exception, as well as
information about the state of the system. You can create a log file
entry at any time using the Log Current State menu item. Log entries
made in this way only contain information about the state of the
system.
.ix 'Log Current State' 'in &drnt'
.ix '&drnt' 'Log Current State'
.np
A log file is a permanent record of the state of the system and,
possibly, your program. With a log file you can make note of an error
and return to it at a later time to examine and debug it.
.*
.beglevel
.*
.section *refid=drntcr Creating A Log File Entry
.*
.np
You can create a log file entry at any time by selecting Log Current
state from the Log menu or the system menu. You can also create a log
file entry when an exception occurs by choosing the Act and Log button
on the Exception dialog.
.np
When a log entry is created the following dialogs may be displayed:
.begbull $compact
.bull
Annotate Log
.bull
Memory Dump
.endbull
.*
.beglevel
.*
.section Using the Annotate Log Dialog
.*
.np
When the Query for notes option in the Log Options dialog is selected,
an Annotate Log dialog box appears whenever a log entry is created.
:CMT. .figure *depth='1.xx' *file='DRWx' In the Annotate Log dialog box, enter text you want to include in the log file entry.
.np
In the space provided, enter any explanatory text that you want to
include in the log file. Press OK when completed. This information
appears under the heading "User Notes" at the beginning of the log file.
.*
.section Using the Memory Dump Dialog
.*
.np
When the Memory Dump option in the Log Options dialog is selected,
&drnt displays the Log Memory Dump dialog whenever a log entry is
created because of an exception. This dialog displays a list of all
committed pages of memory owned by the process that caused the
exception.
:CMT. .figure *depth='1.xx' *file='DRWx' In the Memory Dump dialog box, select the information you want to include in the log file entry.
.np
This dialog allows you to select the memory objects you want to
include in the log file entry. The data contained in any memory object
highlighted in the list box will be written to the log file. Clicking on
an object in the list box toggles it between selected and unselected.
.np
The following buttons are available on the dialog:
.begpoint
.point Select All
Selects all memory for dumping to the log file
.point Clear All
De-selects all memory currently selected in the dialog
.point Cancel
Closes the dialog and continues writing to the log file but does not
include information on any of the memory objects in the dialog
.point OK
Closes the dialog and writes selected objects to the log file
.endpoint
.*
.endlevel
.*
.section Viewing the Current Log File
.*
.np
.ix 'View Log' 'in &drnt'
.ix '&drnt' 'View Log'
Choosing View Log from the Log menu invokes an editor which allows you
to view the current log file. You can select this editor in the Log
Viewer section of the Log Options dialog.
.*
.section Erasing the Log File
.*
.np
.ix 'Log file' 'erase'
.ix '&drnt' 'erase log file'
To erase the current log file, choose Erase Log File from the Log
menu. This erases the log file specified in the Log Options dialog.
.np
Choosing this item reveals a message box which asks you to verify that
you want to erase the specified log file. Select Yes to erase the log
file or No to cancel the request.
.*
.section *refid=drntcu Customizing the Log File
.*
.np
.ix '&drnt' 'Log Options'
.ix 'Log Options' 'in &drnt'
.ix 'Log File' 'customizing'
The Log Options item in the Log menu opens the Log Options dialog
where you indicate to &drnt the information you want to appear in log
file entries. The Log Options item also appears in the system menu.
.keep 23
.figure *depth='3.73' *scale=64 *file='DRW12' In the Log Options dialog, you customize the log file to which you write information.
.np
The following sections describe the options that make up the Log
Options dialog.
.*
.beglevel
.*
.section &drnt.: Naming the Log File
.*
.np
In the Log File field, you specify the file to which &drnt writes the
log file entries. The Browse button to the right of this field opens
the Pick log file name dialog. This dialog lets you browse your file
structure and select the path to which &drnt writes the log file
entries.
.*
.section &drnt.: Choosing the Log Viewer
.*
.np
.ix 'Log Viewer' 'choosing'
In the Log Viewer field, you specify the editor you want to invoke when
you select View Log from the Log menu. The Browse button to the right
of this field opens the Pick log viewer dialog. This dialog lets you
browse your file structure and select the desired editor.
.np
When View Log is selected from the Log menu, this editor will be
invoked with the name of the log file passed as a command line
parameter.
.*
.section &drnt.: Specifying the Log File Data
.*
.np
.ix 'Log File data'
.ix 'Disassembly options'
In the Log File Data and Disassembly Options sections of the Log
Options dialog, you select the information you want to appear in the
log file. The Log File Data section lists the various types of
information that can be included in a log file. If the check box for a
piece of information is marked then that type of information will be
written to the log file. The options in this section are:
.begpoint $break Log File Data
.point Memory Dump
When this box is checked, a Memory Dump dialog is displayed whenever a
log file entry is made. This dialog allows you to select the regions
of memory you want to dump into the log file and is discussed in the
section entitled :HDREF refid='drntcr'..
.np
This option only affects log file entries created because of an
exception.
.point Query for notes
When this box is checked, an Annotate Log dialog is displayed whenever
a log file entry is made. This dialog lets you enter text to be
included in the log file entry. The Annotate Log dialog is discussed
in the section entitled :HDREF refid='drntcr'..
.point Loaded modules
When this box is checked, each log file entry includes a list of all
modules loaded for each process running in the system.
.point Current Processes
When this box is checked, each log file entry includes a list of all
processes currently running in the system, including information about
each process.
.point Mem Manager Info
When this box is checked, log file entries will include summary
information on the memory usage of the process that caused the
exception. This option affects only log file entries created because
of an exception.
.endpoint
.np
The fields in the Disassembly Options section relate to the
disassembly section appearing in the log file. These fields affect
only log file entries made because of exceptions.
.begbull
.bull
The value in the Disasm Backup field tells &drnt the number of
instructions before the fault you want written to the log file.
.bull
The value in the Disasm Lines field tells &drnt the total number of
instructions you want it to show in the log file. This value includes