wdbgcmd.gml

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

You can choose from the following colours:
.begbull
.bull
BLAck
.bull
BLUe
.bull
GREEn
.bull
Cyan
.bull
Red
.bull
MAgenta
.bull
BROwn
.bull
White
.bull
GREY
.bull
GRAy
.bull
BRIght BLUe
.bull
BRIght GREEn
.bull
BRIght Cyan
.bull
BRIght Red
.bull
BRIght MAgenta
.bull
Yellow
.bull
BRIght BROwn
.bull
BRIght White
.endbull
.endnote
.np
Some examples of the paint command follow:
.code begin
paint all plain black on white
paints plain text black on white in all windows.
paint dialog button standout bright green on yellow
.code end

.cmddef Print (or ?)
.np
Use the Print command to prompt for an expression and then print it
to the log window. Use this command to examine the values of
variables and expressions. The Print command is:
.code begin
Print [/Program] [<printlist>]
Print /Window [<exprlist>]
.code end
.begnote
.note /Window
opens up a watch window containing the listed expressions.
.note /Program
print the results to the application's screen.
.note <printlist>
is [<format>] [<exprlist>]
.note <exprlist>
is [<expr> [,<expr> [...]]]
.note <format>
is a printf like format string.  It consists of plain
text intermixed with control sequences, which will
be substituted with values from the expression list.
The control sequences are:
.begnote
.note %i
The corresponding argument is printed out as a signed decimal integer
value.
.note %d
The corresponding argument is printed out as a signed decimal integer
value.
.note %u
The corresponding argument is printed out as an unsigned decimal
integer value.
.note %x
The corresponding argument is printed out as an unsigned hexadecimal
integer value.
Letter digits are printed in lower case (a-f).
.note %X
The corresponding argument is printed out as an unsigned hexadecimal
integer value.
Letter digits are printed in upper case (A-F).
.note %o
The corresponding argument is printed out as an unsigned octal integer
value.
.note %p
The corresponding argument is printed out as a pointer
(segment:offset) value in hexadecimal notation.
.note %c
The corresponding argument is printed out as a single character value.
.note %s
The corresponding argument is printed out as a C/C++ string value.
The argument must point to a string of characters terminated by a byte
whose value is zero.
.note %%
To print out a percentage symbol, the "%" must be doubled up (i.e.,
%%).
.note %f
The corresponding argument is printed out in floating-point
representation.
If the floating-point value has a very large or small magnitude, you
should use one of "g", "G", "e" or "E" formatting.
.note %g
The corresponding argument is printed out in floating-point
representation.
Numbers of very large or small magnitude are printed out in scientific
"E" notation (e.g., 1.54352e+16).
The exponent letter is printed in lower case.
.note %G
The corresponding argument is printed out in floating-point
representation.
Numbers of very large or small magnitude are printed out in scientific
"E" notation (e.g., 1.54352E+16).
The exponent letter is printed in upper case.
.note %e
The corresponding argument is printed out in scientific "E" notation
(e.g., 1.23456e+02).
The exponent letter is printed in lower case.
.note %E
The corresponding argument is printed out in scientific "E" notation
(e.g., 1.23456E+02).
The exponent letter is printed in upper case.
.note %r
The corresponding argument is printed out in the current default
numeric radix.
.note %a
The corresponding argument is printed out as a symbol reference
(symbol_name+offset) when possible; otherwise it is printed out
as a pointer (segment:offset) value in hexadecimal notation.
.note %l
The corresponding argument is printed out as a line number reference
(module_name@line_number+offset) when possible; otherwise it is
printed out as a pointer (segment:offset) value in hexadecimal
notation.
.endnote
.endnote
.np
Some examples of the print command follow.
This command prints the value of "i":
.code begin
? i
.code end
.np
This command prints "decimal=100 hex=0x64":
.code begin
print {decimal=%d hex=%x} 100,100
.code end
This command opens a watch window and displays the value of argv[0]:
.code begin
print/window argv[0]
.code end

.cmddef Quit
.np
Use the Quit command to leave the debugger.

.cmddef RECord
.np
Use the Record command to add a command to the replay window. This
command is for internal use only. The format
of the command is:
.code begin
REcord<expr> <command>
.code end

.cmddef Register
.np
The format of the Register command is:
.code begin
Register <intexpr>
.code end
.np
If intexpr is negative, this is
equivalent to using the menu item Undo/Undo -<intexpr> times.
If intexpr is positive, this is
equivalent to using the menu item Undo/Redo <intexpr> times.

.cmddef REMark (or *)
.np
Use the Remark command to enter lines of comments. The format of the
command is:
.code begin
REMark <string>
.code end

.cmddef Set
.np
These commands are used internally by the debugger to save and restore
the configuration. The syntax is:
.code begin
Set AUtosave [ON|OFf]
Set ASsembly [Lower|Upper] [Outside|Inside] [Source|NOSource] [Hexadecimal|Decimal]
Set Variable [Entire|Partial] [CODe|NOCODe] [INherit|NOINherit] [COMpiler|NOCOMpiler] [PRIvate|NOPRIvate] [PROtected|NOPROTected] [Members|NOMembers]
Set FUnctions [Typed|All]
Set GLobals [Typed|All]
Set REGister [Hexadecimal|Decimal] [Extended|Normal]
Set Fpu [Hexadecimal|Decimal]
Set Bell [ON|OFf]
Set Call [/Far|/Interrupt|/Near] [ ( [<location> [,<location> [...]]] ) ]
Set Dclick <expr>
Set Implicit [ON|OFf]
Set INput <wndname>
Set Radix <expr>
Set RECursion [ON|OFf]
Set SEarch [CASEIgnore|CASEREspect] [Rx|NORx] <string>
Set SOurce [/Add] [<path> [<path>] [...]]]
Set SYmbol [/Add|/Ignore|/Respect] [<lookspec> [<lookspec> [...]]]
Set Tab <intexpr>
Set Level [Assembly|Mixed|Source]
Set LAnguage [CPP|C|FORTRAN]
Set SUpportroutine <string>
Set MAcro <wndname> <key> <command>
.code end
.begnote
.note <location>
see call command.
.note <lookspec>
[/Ignore|/Respect] <string>
.endnote

.cmddef SHow
.np
The Show commands are used internally by the debugger to save and
restore its configuration. The syntax is:
.code begin
SHow Paint
SHow Display
SHow Font
SHow Set
SHow Set AUtosave
SHow Set ASsembly
SHow Set Variable
SHow Set FUnctions
SHow Set GLobals
SHow Set REGister
SHow Set Fpu
SHow Set Bell
SHow Set Call
SHow Set Dclick
SHow Set Implicit
SHow Set INput
SHow Set Radix
SHow Set RECursion
SHow Set SEarch
SHow Set SOurce
SHow Set SYmbol
SHow Set Tab
SHow Set Level
SHow Set LAnguage
SHow Set MAcro
SHow Set SUpportroutine
SHow Flip
SHow Hook
.code end

.cmddef SKip
.np
Use the Skip command to set CS:EIP to a specific address. The format
of the command is:
.code begin
SKip <address>
.code end

.cmddef STackpos <intexpr>
.np
The Stackpos command is the same as using Undo/Unwind. The <intexpr>
allows you to define the number of times to undo or unwind.

.cmddef SYstem (or !)
.np
Use the System command to spawn an operating shell to execute a given
string. The format of the system command is:
.code begin
SYstem [/Remote|/Local] <string>
.code end
.np
.begnote
.note /Remote
the shell is started on the program side of a remote debug link.
.note /Local
the shell is started on the debugger side of a remote debug link.
.endnote

.cmddef THread (or ~~)
.np
Use the Thread command to manipulate the threads of execution of a
multi-threaded application under OS/2 or NetWare 386. The format of the
Thread command is:
.code begin
THread [/Show|/Freeze|/Thaw|/Change] [<threadid>]
.code end
.begnote
.note /Show
display the status of the current thread.
.note /Freeze
freeze a thread and make it unrunnable.
.note /Thaw
make a frozen thread runnable.
.note /Change
to select a specific thread.
.note <threadid>
is the identification number of the thread.
.endnote

.cmddef Trace
.np
Use the Trace command to step through the execution of your program. The
Trace command is:
.code begin
Trace [/Assembly|/Mixed|/Source] [/Into|/Next|/Over]
.code end
.np
.begnote
.note /Assembly
trace through your assembly code on instruction
at a time.
.note /Mixed
trace execution of the application one source statement at a time,
or one instruction at a time when no source text is available.
.note /Source
trace execution of the application one source statement at a time.
.note /Into
continue execution to the next statement or assembly instruction.
If the current statement or instruction invokes a routine, then the next
statement or instruction is the first one called in the routing.
.note /Next
continue execution to the next statement or assembly instruction
that immediately follows the current statement or instruction in memory.
If the current statement or instruction is one that branches, be sure
that the execution path eventually executed the statement
or instruction that follows. If the program does not executed
this point, the program may execute to completion.
.note /Over
continue execution to the next statement or
assembly instruction. If the current statement or instruction
invokes a routine, then the next statement or instruction
is the one that follows the invocation of the routine.
.endnote

.cmddef Undo
.np
The format of the Undo command is:
.code begin
Undo <intexpr>
.code end
.np
If intexpr is positive, this is
equivalent to using the menu item Undo/Undo <intexpr> times.
If intexpr is negative, this is
equivalent to using the menu item Undo/Redo -<intexpr> times.

.cmddef View
.np
Use the View command to show a file in a window. The
format of the command is:
.code begin
View [/Binary] [<file>|<module>]
.code end
.begnote
.note /Binary
show the file contents in binary.
.note <file>
the file to be shown.
.note <module>
the module to be shown.  The default is the current module.
.endnote

.cmddef While
.np
Use the While command to permit the execution of a list of commands
while the specified expression is true. The While command is:
.code begin
While <expr> { <command> }
.code end

.cmddef WIndow
.np
This command operates on the current window. It is useful when
defining accelerators that perform window operations.
.begnote $break
.note WIndow CLose
close the window
.note WIndow CURSORStart
move the cursor to start of line
.note WIndow CURSOREnd
move the cursor to end of line
.note WIndow CURSORDown
move the cursor down one line
.note WIndow CURSORLeft
move the cursor left
.note WIndow CURSORRight
move the cursor right
.note WIndow CURSORUp
move up one line
.note WIndow Dump
dump the window to a file
.note WIndow Log
dump the window to a log window
.note WIndow FINDNext
find the next occurrence of the current search string
.note WIndow FINDPrev
find the previous occurrence of the current search string
.note WIndow Next
make another window the current window
.note WIndow PAGEDown
move the window down one page
.note WIndow PAGEUp
move the window up one page
.note WIndow POpup
show the window's floating pop-up menu
.note WIndow SEarch
search for a given string
.note WIndow SCROLLDown
scroll the window down one line
.note WIndow SCROLLUp
scroll the window up one line
.note WIndow SCROLLTop
scroll the window to the very top
.note WIndow SCROLLBottom
scroll the window to the very bottom
.note WIndow TABLeft
move to the previous tabstop
.note WIndow TABRight
move to the next tabstop
.note WIndow MAXimize
maximize the window
.note WIndow MINimize
minimize the window
.note WIndow REStore
restore the window
.note WIndow TIle
tile all windows
.note WIndow CAscade
cascade all windows
:cmt..note WIndow Move
:cmt.not yet implemented
:cmt..note WIndow SIze
:cmt.not yet implemented
.note WIndow PRevious
move to the previous window
.endnote
.endlevel