protocol
debuggerp
Debugger protocol.
logtalk_load(debugger(loader))static
Debugger help: Type the character
h(condensed help) or the character?(extended help) at a leashed port.Predicate breakpoint: Specified as a ground term
Functor/Arity.Non-terminal breakpoint: Specified as a ground term
Functor//Arity.Clause breakpoint: Specified as an
Entity-Lineterm with bothEntityandLinebound.Linemust be the first source file line of an entity clause.Conditional breakpoint: Specified as an
Entity-Lineterm with bothEntityandLinebound and a condition.Linemust be the first source file line of an entity clause.Hit count breakpoint: Specified as an
Entity-Lineterm with bothEntityandLinebound and an unification count expression as a condition.Linemust be the first source file line of an entity clause.Triggered breakpoint: Specified as an
Entity-Lineterm with bothEntityandLinebound and another breakpoint as a condition.Linemust be the first source file line of an entity clause.Context breakpoint: Specified as a
(Sender, This, Self, Goal)tuple.Log point: Specified as an
(Entity, Line, Message)tuple.Leash port shorthands:
none-[],loose-[fact,rule,call],half-[fact,rule,call,redo],tight-[fact,rule,call,redo,fail,exception], andfull-[fact,rule,call,exit,redo,fail,exception].
Public predicates
reset/0
Resets all debugging settings (including breakpoints, log points, and leashed ports) and turns off debugging.
staticreset - onedebug/0
Starts debugging for all defined breakpoints.
staticdebug - onenodebug/0
Stops debugging for all defined breakpoints. Also turns off tracing. Does not remove defined breakpoints.
staticnodebug - onedebugging/0
Reports current debugging settings, including breakpoints and log points.
staticdebugging - onedebugging/1
Enumerates, by backtracking, all entities compiled in debug mode.
staticdebugging(Entity)debugging(?entity_identifier) - zero_or_moretrace/0
Starts tracing all calls compiled in debug mode.
statictrace - onenotrace/0
Stops tracing of calls compiled in debug mode. Debugger will still stop at defined breakpoints.
staticnotrace - oneleash/1
Sets the debugger leash ports using an abbreviation (none, loose, half, tight, or full) or a list of ports (valid ports are fact, rule, call, exit, redo, fail, and exception).
staticleash(Ports)leash(+atom) - oneleash(+list(atom)) - oneleashing/1
Enumerates, by backtracking, all leashed ports (valid ports are fact, rule, call, exit, redo, fail, and exception).
staticleashing(Port)leashing(?atom) - zero_or_morespy/1
Sets a predicate or clause breakpoint (removing any existing log point or breakpoint defined for the same location, or a list of breakpoints. Fails if a breakpoint is invalid.
staticspy(Breakpoint)spy(@spy_point) - zero_or_onespy(@list(spy_point)) - zero_or_onespying/1
Enumerates, by backtracking, all defined predicate and clause breakpoints.
staticspying(Breakpoint)spying(?spy_point) - zero_or_morenospy/1
Removes all matching predicate and clause breakpoints.
staticnospy(Breakpoint)nospy(@var) - onenospy(@spy_point) - onenospy(@list(spy_point)) - onespy/3
Sets a conditional or triggered breakpoint (removing any existing log point or breakpoint defined for the same location). The condition can be a unification count expression, a lambda expression, or another breakpoint. Fails if the breakpoint is invalid.
staticspy(Entity,Line,Condition)spy(+atom,+integer,@callable) - zero_or_one
Unification count expression conditions:
>(Count),>=(Count),=:=(Count),=<(Count),<(Count),mod(M), andCount.Lambda expression conditions:
[Count,N,Goal]>>Conditionand[Goal]>>ConditionwhereCountis the unification count,Nis the invocation number, andGoalis the goal that unified with the clause head;Conditionis called in the context ofuser.Triggered breakpoint conditions:
Entity-Line.
spying/3
Enumerates, by backtracking, all conditional and triggered breakpoints.
staticspying(Entity,Line,Condition)spying(?atom,?integer,?callable) - zero_or_morenospy/3
Removes all matching conditional and triggered breakpoints.
staticnospy(Entity,Line,Condition)nospy(@term,@term,@term) - onespy/4
Sets a context breakpoint.
staticspy(Sender,This,Self,Goal)spy(@term,@term,@term,@term) - onespying/4
Enumerates, by backtracking, all defined context breakpoints.
staticspying(Sender,This,Self,Goal)spying(?term,?term,?term,?term) - zero_or_morenospy/4
Removes all matching context breakpoints.
staticnospy(Sender,This,Self,Goal)nospy(@term,@term,@term,@term) - onenospyall/0
Removes all breakpoints and log points.
staticnospyall - onelog/3
Sets a log point (removing any existing breakpoint defined for the same location). Fails if the log point is invalid.
staticlog(Entity,Line,Message)log(@object_identifier,+integer,+atom) - zero_or_onelog(@category_identifier,+integer,+atom) - zero_or_onelogging/3
Enumerates, by backtracking, all defined log points.
staticlogging(Entity,Line,Message)logging(?object_identifier,?integer,?atom) - zero_or_morelogging(?category_identifier,?integer,?atom) - zero_or_morenolog/3
Removes all matching log points.
staticnolog(Entity,Line,Message)nolog(@var_or(object_identifier),@var_or(integer),@var_or(atom)) - onenolog(@var_or(category_identifier),@var_or(integer),@var_or(atom)) - onenologall/0
Removes all log points.
staticnologall - oneProtected predicates
(none)
Private predicates
(none)
Operators
(none)
See also