wdbgcmd.gml

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

These are the x and y coordinates of the top left
corner, and the width and the height of the window respectively.
0,0,10000,10000 is a window covering the entire screen.
.note /Open
Open a new window or resize an existing one.
.note /New
Open a new window regardless of an existing one.
.note /Close
Close the window.
.note /MInimize
Iconize the window.
.note /MAximize
Make the window full screen size.
.note /REstore
Restore a window from a minimize or maximize.
.endnote
.np
Some examples of the display command follow:
This command opens a register window in the top left quarter of the
screen:
.code begin
display register /open 0,0,5000,5000
.code end
.np
This command minimizes the source window if it is open:
.code begin
display source /minimize
.code end

.cmddef DO (or /)
.np
Use the DO command to evaluate an arbitrary C/C++ or FORTRAN expression.
The format of the command is:
.code begin
DO <expr>
.code end
.np
For example:
.code begin
DO i = 10
.code end

.cmddef ERror
.np
Use the Error command to display a string as an error message. The
format of the command is:
.code begin
ERror <string>
.code end
.np
For example:
.code begin
error {An error has been detected}
.code end

.cmddef Examine
.np
Use the Examine command to examine memory at a specific address.
.code begin
Examine [/<type>] [<address>] [,<follow> [,<len>]]
.code end
.pc
where "<type>" is one of
.code begin
Byte
Word
Dword
Qword
Char
Short
Long
__int64
Unsigned_Char
Unsigned_Short
Unsigned_Long
Unsigned___int64
0:16_Pointer
16:16_Pointer
0:32_Pointer
16:32_Pointer
Float
Double
Extended_Float
.code end
.np
To show an assembly window at a specific address:
.code begin
Examine /Assembly [<address>]
.code end
.np
To show a source window at a specific address
.code begin
Examine /Source [<address>]
.code end
.np
To add an address to the I/O window as a byte, word, or dword:
.code begin
Examine [/IOByte|/IOWord|/IODword] [<address>]
.code end
.np
The options for the Examine command follow:
.begnote $break
.note /<type>
where "<type>" is one of
.mono Byte,
.mono Word,
.mono Dword,
.mono Qword,
.mono Char,
.mono Short,
.mono Long,
.mono __int64,
.mono Unsigned_Char,
.mono Unsigned_Short,
.mono Unsigned_Long,
.mono Unsigned___int64,
.mono 0:16_Pointer,
.mono 16:16_Pointer,
.mono 0:32_Pointer,
.mono 16:32_Pointer,
.mono Float,
.mono Double,
or
.mono Extended_Float.
Set the initial display type of the memory window.
.note /IOByte /IOWord /IODword
Set the initial display type of the line in the I/O window.
.note <address>
the address to examine.
.note <follow>
an expression which will be used if the memory window's Repeat
function is chosen.
.note <len>
an integer expression indicating the length of memory to examine.
.endnote
.np
For example, this command opens a memory window positioned at the
address of "foo".  The initial display type will be 2 byte words.
If the
.mi Repeat
menu item is used, it will follow a near pointer 4 bytes past the
beginning of the window *(.+$). The window will display 16 bytes of
data at a time:
.code begin
examine /word foo,*(.+4),16
.code end

.cmddef Flip
.np
Use the Flip command to configure screen flipping.  See the section
entitled :HDREF refid='dlgopt'. for details
.code begin
Flip ON
Flip OFf
.code end

.cmddef FOnt
.np
Use the Font command to set the font for the specified window. The
command is:
.code begin
FOnt <wndname> <fontinfo>
.code end
.begnote
.note <wndname>
the name of the affected window
.note <fontinfo>
operating system specific font data.
.endnote

.cmddef Go
.np
Use the Go command to start or continue program execution. Execution
then resumes at the specified address or at the location defined by
the current contents of the CS:IP or CS:EIP register pair. The format
of the Go command is:
.code begin
Go [/Until] [/Keep] [/Noflip] [[<start>,]<stop>]
.code end
.np
The options are:
.begnote $break
.note /Until
.ix 'until'
skips breakpoints until the specified stop address is reached.
.note /Keep
.ix 'keep'
allows you to keep a previous temporary breakpoint.  If you keep
the previous breakpoint you cannot create a new one.
.note /Noflip
.ix 'noflip'
keeps the debugger from flipping to the application's screen.
.note <start>
the <address> at which to start execution (optional).
.note <stop>
the <address> at which to stop execution.
.endnote
.np
Some examples of the Go command are:
.np
This command will resume execution until function "foo" is executed
without flipping to the application screen:
.code begin
go /noflip foo
.code end
.np
This command starts execution at "foo" and runs until "bar" is executed.
.code begin
go foo,bar
.code end

.cmddef Help
.np
Bring up the help screen:
.code begin
Help
.code end

.cmddef HOok
.np
Use the Hook command to execute a command when a defined event occurs.
The format of the Hook command is:
.code begin
HOok <event> <command>
.code end
.np
<event> can be any of the following:
.begnote $break
.note PROGStart
a program is loaded
.note PROGEnd
a program terminates
.note DLLStart
a DLL is loaded
.note DLLEnd
a DLL is unloaded
.note EXECStart
program execution is beginning
.note EXECEnd
program execution is stopped
.note Sourceinfo
the current location being examined has debugging information
.note Assemblyinfo
the current location being examined has no debugging information
.note Modulechange
the current location being examined has changed modules
.endnote
.np
This example causes the locals and source window to
come to the front whenever a region with symbolic
debugging information is entered:
.code begin
hook sourceinfo {display locals; display source}
.code end

.cmddef IF
.np
Use the If command to evaluate an expression and then, depending on the
results, execute a list of commands. The format of the If command is:
.code begin
IF <expr> { <command> }
[ ELSEIF <expr> { <command> } [ ELSEIF <expr> { <command> } [...]]]
[ELSE { <command> }]
.code end
.np
If the expression results in a non-zero value, the list of debugger
commands contained after the IF expression are executed. Otherwise,
the list of commands that appear after the ELSEIF expression are
executed.

.cmddef INvoke (or <)
.np
Use the Invoke command to invoke a file containing a number of
debugger commands. The format of the Invoke command is:
.code begin
INvoke <file> [<string> [<string> [...]]]
<      <file> [<string> [<string> [...]]]
.code end
.begnote
.note <file>
is the name of the command file to invoke.
.note <string>
will be passed as a parameter.  These parameters may be
referenced in the command file as <1>, <2>, etc.
.endnote

.cmddef Log (or >)
.np
Use the Log command to send the Dialog window output to a specified
file. The following commands start logging to a file:
.code begin
Log        <file>
Log /Start <file>
>          <file>
.code end
.np
The following commands start appending log information to a file.
.code begin
Log >       <file>
>>          <file>
Log /Append <file>
.code end
.np
The following commands stop logging:
.code begin
Log
>
.code end

.cmddef MOdify
.np
Use the Modify command to change memory at an address to the values
specified by the list of expressions.
.code begin
MOdify [/Byte|/Pointer|/Word|/Dword|/IOByte|/IOWord|/IODword] <address>[,<expr>[...]]
.code end
.np
The options for the modify command are:
.begnote
.note /Byte /Pointer /Word /Dword
Control the size of memory to be modified.
.note /IOByte /IOWord /IODword
Control the size of the I/O port to be modified.
.note <address>
The address to modify.
.note <expr>
The values to be placed in memory.
.endnote
.np
This command changes the 3 bytes at location "foo" to the values 1, 2
and 3:
.code begin
modify /byte foo 1,2,3
.code end
.np
This command changes the 4 bytes at location "foo" to the value
12345678 hex:
.code begin
modify /dword foo 0x12345678
.code end

.cmddef NEW
.np
Use the New command to initialize various items. The format of the New
command is:
.code begin
NEW [<args>]
NEW /Program [[:<symfile>] <progfile> [<args>]]
NEW /Restart [<args>]
NEW /STDIn <file>
NEW /STDOut <file>
NEW /SYmbol <file> [seg [,seg [...]]
.code end
.np
.begnote
.note <symfile>
represents a file containing the symbolic information.
.note <progfile>
represents the executable file.
.note <args>
represent the arguments to be passed to the program.
.note /Restart
Reload the current application and place it into an initial
state so that you may begin execution again. The application may have
already partially or completely executed.
.note /STDIn
associate the standard input file handle with a particular file
or device.
.note /STDOut
associate the standard output file handle with a particular
file or device.
.note /Symbol
load additional symbolic debugging information and specify the
mapping between the linker addresses and the actual execution addresses.
.endnote

.cmddef PAint
.np
Use the Paint command to define window or dialog
colours. To define the colour for windows, use the following command:
.code begin
PAint [Status|<wndname>] <wndattr> <color> ON <color>
.code end
.np
To define the colour for dialogs in the character-based version of
the debugger, use the following command:
.code begin
PAint DIalog <dlgattr> <color> ON <color>
.code end
.np
The paint options are as follows:
.begnote
.note <wndattr>
allows you to define the window attributes. You can
choose from the following items:
.begnote
.note MEnu Plain
menu text (character-based)
.note MEnu STandout
menu accelerator key (character-based)
.note MEnu Disabled
grayed menu item (character-based)
.note MEnu Active
menu item under the cursor (character-based)
.note MEnu Active STandout
menu accelerator key under the cursor (character-based)
.note MEnu Frame
frame of the menu (character-based)
.note MEnu Disabled Active
grayed menu item under the cursor (character-based)
.note TItle Disabled
a non active window's title
.note Frame Active
the frame of the active window (character-based)
.note Frame Disabled
the frame an inactive window (character-based)
.note ICon
an icon
.note Plain
normal text within a window
.note Active
window text under the cursor
.note SElected
window text being selected
.note STandout
window text the debugger wishes to highlight
.note Active STandout
window text the debugger wishes to highlight under the cursor
.note BUtton
the gadgets on the left side of a window (character-based)
.endnote
.note <dlgattr>
option allows you to define the dialog attributes. The possible
options are:
.begnote
.note Plain
normal text
.note Frame
the dialog frame
.note SHadow
the shadow of a button
.note BUtton Plain
normal button text
.note BUtton STandout
button accelerator key character
.note BUtton Active
a button which has focus
.note BUtton Active STandout
button accelerator key character of a button with focus
.endnote
.note <color>