Arguments: [:i] [:c] [name|index]
If not in ldb mode (ldb does not appear in the prompt), this command prints information on local variables in the current frame, as we now describe. See below for behavior in ldb mode.
This command causes the values of local variables for the current stack frame (see :zoom) to be printed. See debugging.htm for information on the handling of local variables by the debugger.
Note that the compiler may not save the names of local variables in
compiled code. In that case variables will be listed identified by an
index, which is a number from 0 to n-1, where n is the number of
compiled local variables. The compiler will save names of compiled
local variables if the compiler switch compiler:save-local-names-switch is bound
to a function which returns t.
When local names are saved (as described in the paragraph above), closure variables are also printed out.
If the name/index option is specified, the value
of the local variable identified by the name or index will be
printed. With no other options, all instances of
name are looked for. If the option
:i (:c) is specified, just interpreted
(compiled) code is searched for name. index
always refers to compiled local variables. The variable
cl:* is set only if you specify a
name or index argument to
:local. The commands :local, :local :i and
:local :c do not set *.
The minimal abbreviation for :localis :loc.
See also :set-local.
This command operates on the focused process when multiprocessing is active. See :focus.
:local in ldb mode
When in ldb-step mode, the :local command works as follows:
When a breakpoint is hit, the default current frame is the context in which the breakpoint occurred (and thus ldb-step mode was entered). If at this frame, the :local command is given with no arguments, a list of all registers is printed, along with their values. The names of the registers can be used in the :local command to print only one value, just as in a regular frame.
The :x modifier can be used to ask for any numeric output
in hexadecimal. Typical register names start with :% and are named
according to hardware convention, eg. :%r10, :%ebx (on x86), :%i3 (on
sparc).
See top-level.htm for more information on top-level commands. See debugging.htm for information on the debugger.
The documentation is described in introduction.htm and the index is in index.htm.
Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.
Created 2000.10.5.