Breakpoints

General Syntax

		 
break [location [? expr]]
Where
location corresponds to an address in the program or a line number in a source file
expr corresponds to a conditional expression associated with the breakpoint

The value of location may be specified by one of the following items:

• ['file'] line specifies line number line in the source file file. If omitted, file defaults to the current file.
• proc [+|- offset] specifies the line number corresponding to the entry point of function or subroutine proc plus or minus offset lines. When using this syntax, proc may not be a module or internal procedure.
• proc@_inproc specifies internal procedure inproc within proc.
• mod@_proc[@_inproc] specifies procedure proc contained in module mod or internal procedure inproc within module procedure proc
• *addr specifies a physical address (default radix is hexadecimal).
• If location is omitted, it defaults to the current line of code

The conditional expression expr can be constructed of program variables, typedef elements, and constants, along with the following operators:

• Minus unary operator (-)
• Plus unary operator (+)
• Assignment statement (=)
• Scalar relational operator (<, <=, ==, /=, >, >=, .LT., .LE., .EQ., .NE., .GT., .GE.)
• Logical operator (.NOT., .AND., .OR., .EQV., .NEQV.)

break [ 'file' ] line

Sets a breakpoint at the line number line in the source file file. If omitted, file defaults to the current file. Note that the "apostrophes" in `file`, above, are the standard apostrophe character (ascii 39).

[ 'file' ] funcname

Sets a breakpoint at the entry point of the function funcname in the source file file. If omitted, file defaults to the current file. Note that the "apostrophes" in `file`, above, are the standard apostrophe character (ascii 39).

break *addr

Sets a breakpoint at address addr.

break

Sets a breakpoint at the current line.

breakon [#n]

Enables the breakpoint number n. If #n is omitted, all breakpoints are enabled. Note that the “#” symbol is required.

breakoff [#n]

Disables, but does not remove, the breakpoint number n. If #n is omitted, all breakpoints are disabled. Note that the “#” symbol is required.

condition #n expr

Associate conditional expression expr with the breakpoint whose serial number is n. Note that the "#" symbol is required.

condition #n

Remove any condition associated with the breakpoint whose serial number is n. Note that the "#" symbol is required.

oncebreak

Sets a temporary breakpoint that is deleted after the program is stopped at the breakpoint once. OnceBreak in other regards, including arguments, works like Break.

regularbreak "regex"

Set a breakpoint at the beginning of all functions or procedures with a name matching regular expression regex.

delete location

Removes the breakpoint at location location as described in above syntax description.

delete [ 'file' ] line

Removes the breakpoint for the line number line in the source file specified as file. If omitted, file defaults to the current file. Note that the "apostrophes" in `file`, above, are the standard apostrophe character (ascii 39).

delete [ 'file' ] funcname

Removes the breakpoint for the entry point of the function funcname in the source file file. If omitted, file defaults to the current file. Note that the "apostrophes" in `file`, above, are the standard apostrophe character (ascii 39).

delete *addr

Removes the breakpoint for the address addr.

delete #n

Removes breakpoint number n.

delete

Removes all breakpoints.

skip #n count

Skips the breakpoint number n count times.

onstop #n cmd[;cmd2;cmd3...;cmdn]

Upon encountering breakpoint n, execute the specified fdb command(s).

show break

B

Displays all breakpoints. If using the abbreviation "B", the "B" must be uppercase.