br (Breakpoint Register)


br[number] flags [count] ["cmds"]

The br command sets an debug register breakpoint. Debug registers can be used to break on data reads and writes and instruction execution. Up to four debug registers can be set and enabled at one time.

number

Specifies which breakpoint is being created. No space is allowed between the br command and the number parameter. If number is omitted, the first available breakpoint number is used.

flags

Specifies the length and break conditions for the breakpoint. This parameter can be some combination of the following values:

1

Set 1-byte length (default value).

2

Set word length on word boundary.

4

Set doubleword length on doubleword boundary.

E

Break on instruction execution only (1-byte length only).

W

Break on writes only.

R

Break on reads and writes.


count

Specifies the number of times the breakpoint is to be ignored before being executed. It can be any 16-bit value.

cmds

Specifies an optional list of debugger commands to be executed in place of the default command when the breakpoint is reached. You must enclose the group of optional commands in quotation marks and separate optional commands with semicolons (;).