add-breakpoint

$Revision: 5.0.2.4 $

Function

Package: EXCL

Arguments: (func pc &optional temporary verbose)

Adds a breakpoint to the breakpoint table, if one does not already exist. Breakpoints are identified by func, which must be a function object, and pc, which must be a integer indicating the relative pc offset (look at a disassembly of func produced by cl:disassemble for offsets). When adding a breakpoint, if the pc specified is not exact, a "close" one is found. The exact algorithm is not easily described and is subject to change. The breakpoint structure is returned.

If temporary is true, the breakpoint is considered temporary (subject to removal after the next breakpoint is hit). Temporary breakpoints have less "priority" than non-temporaries; a temporary will not replace a non-temporary in the same location, but a non-temporary will replace a temporary. Breakpoints of the same priority will not replace each other at the same location.

The verbose argument, when non-nil, will show the disassembly of the breakpoint being added.

See 12.0 The Lisp DeBug (ldb) stepper in debugging.htm. The general documentation description is in introduction.htm. The index is in index.htm.