Top-level Command |  | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version

## :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

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 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-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.

|  | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version