:trace

Arguments: &rest function-or-option-list

When called with no arguments, all the functions currently being traced are printed, otherwise the arguments to :trace are function names (symbols) or option lists. An option list starts with a function name, and the other elements of the list are options for tracing that particular function. The options for one function do not affect the tracing of any other function. The options come in pairs, the first element of the pair being the option name (i.e., a keyword), and the second part being the option value. Missing options default to nil. Here are some valid calls to :trace:

:trace foo
:trace foo (bar :break-before t) baz
:trace (baz :inside foo :break-before t)
:trace 

Note that the following is invalid:

:trace foo :inside bar   ;; INVALID WILL CAUSE ERROR

You must enclose options in a list along with the function name and the option value. If you enter the invalid case above, Lisp will complain that :inside does not have a function definition. The correct command is:

:trace (foo :inside bar)

The minimal abbreviation of :trace is :tr.

See top-level.htm for more information on top-level commands. See See The tracer in debugging.htm for information on the debugger and examples of tracing.

Valid options to :trace

The options to :trace are listed in The tracer in debugging.htm. In brief the options and their arguments are:

• :condition expr
• :break-before val
• :break-after val
• :break-all val
• :inside func
• :not-inside func
• :print-before expr
• :print-after expr
• :print-all expr
• :show-stack n

Again, see The tracer in debugging.htm for details.

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.