5.4.2 Command Parameters

You can separate 80386 Debugger command parameters with delimiters (spaces or commas), but a delimiter is required only between two consecutive hexadecimal values. The following commands are equivalent:

dCS:100 110
d CS:100 110
d,CS:100,110

Following are the parameters you can use with 80386 Debugger commands:

addr

Represents an address parameter in one of four forms. For more information about the operators shown in the following address forms, see Section 5.4.3, “Binary and Unary Operators.”

Address Mode

#1f:02C0 Protected-mode address (selector:offset)
%31020 Linear address
%%31020 Physical address
&0100:02FF Real-mode address (segment:offset)

Any of these specified address forms overrides the current address type.

byte

Specifies a two-digit hexadecimal value.

cmds

Specifies an optional set of debugger commands to be executed with the bp (Set Breakpoint) or j (Conditionally Execute) command.

count

Specifies a count. Valid values depend on the command with which this parameter is being used.

dword

Represents an eight-digit (4-byte) hexadecimal value. The DWORD data type is most commonly used as a physical address.

expr

Represents a combination of parameters and operators that evaluates to an 8-bit, 16-bit, or 32-bit value. An expr parameter can be used as a value in any command. An expr parameter can combine any symbol, number, or address with any of the binary and unary operators.

flags

Specifies one or more conditions. Valid conditions depend on the command with which this parameter is being used.

group-name

Specifies the name of a group that contains the map symbols you want to display.

list

Specifies a series of byte values or a string. The list parameter must be the last parameter on the command line. Following is an example of the f (Fill) command with a list parameter:

fCS:100 42 45 52 54 41

map-name

Specifies the name of a symbol map file.

name-chars

Specifies one or more characters.

number

Specifies a numeric value. Valid values depend on the command with which this parameter is being used.

object

Specifies a handle, a selector, or (in 386 enhanced mode) a heap address.

option

Specifies an option. Valid options depend on the command with which this parameter is being used.

range

Specifies the block of memory on which the command should operate. The range parameter can be two addresses (addr addr); or it can be one address and a length (addr L word, where word is the number of items on which the command should operate; 80h is the default value). Following are three valid examples:

CS:100 110
CS:100 L 10
CS:100

The limit for range is 10000h. To specify a word of 10000h using only four digits, use 0000h or 0h.

reg

Specifies the name of a microprocessor register.

string

Represents any number of characters enclosed in single quotation marks (') or double quotation marks ("). For quotation marks that must appear within string, you must use two sets of quotation marks. For example, the following strings are valid:

'This ''string'' is OK.'
\"This \"\"string\"\" is OK.\"

However, the following strings are not valid:

\"This \"string\" is not OK.\"
\"This 'string' is not OK.\"

The ASCII values of the characters in the string are used as a list of byte values.

word

Specifies a four-digit (2-byte) hexadecimal value.