There are some additional messages. For example, when load tracking is on and a load
command cites a nonexistent file, a debugging message mentioning the failed load command
is issued.
$dbg Subcommands (Arguments)
Subcommand | Significance |
(none) | Display all current settings. |
1 or 0 |
Turn all tracing and tracking on (1) or off (0). |
beam b
+beam
-beam |
Turn beam tracking (mapping and unmapping)
on (+beam or
b=1) or
off (-beam or
b=0), or
toggle (just beam). |
bitwise
b
+bitwise
-bitwise |
Turn checking for nonboolean And and Or arguments
on (+bitwise or
b=1) or
off (-bitwise or
b=0), or
toggle (just bitwise).
The default is to check. |
char x |
Set character to be used in dbg messages (see example above). |
+cxt c
-cxt c |
Limit tracing to the contexts listed in c
(+) or all but the contexts listed in
c (-). If
c is absent, trace all contexts (whether
+ or -). Message indentation always
corresponds to execution depth, regardless of omissions. |
def b
+def
-def |
Turn tracking of function and dependency definition
on (+def or
b=1) or
off (-def or
b=0), or
toggle (just def). |
dep b
+dep
-dep |
Turn dependency evaluation tracing
on (+dep or
b=1) or
off (-dep or
b=0), or
toggle state (just dep). |
disp map |
Display the limit on the number of concurrently mapped files; a list of
files currently mapped, with reference counts; and some internal index
information. |
display beam |
Display all current mappings of files. |
display flags |
Display the value of several key system variables; highlight nondefault
values. |
do b
+do
-do |
Turn Monadic-Do tracing
on (+do or
b=1) or
off (-do or
b=0), or
toggle state (just do). |
dyld b
+dyld
-dyld |
Turn dynamic load tracking on
(+dyld or
b=1) or
off (-dyld or
b=0), or
toggle state (just dyld). |
fmt b
+fmt
-fmt |
Turn messages from _fmt
on (+fmt or
b=1) or
off (-fmt or
b=0), or
toggle state (just fmt). The default is no message display. |
func b
+func
-func |
Turn defined function and operator tracing
on (+func or
b=1) or
off (-func or
b=0), or
toggle state (just func). |
help | Display all permissible settings and their significance. |
indent n |
Set dbg message indentation per level of execution depth. |
inv b
+inv
-inv |
Turn on (+inv or
b=1) or off (-inv
or b=0) or toggle (just
inv) the tracing of dependency invalidations and the triggering of
a callback (if a callback function is defined, using
_dbg). Messages are
indented to make tracing of dependency trees easier. A warning is issued
when inv is on and a cyclic dependency is encountered during
invalidation. |
levels n |
Maximum (execution) depth of tracing. 0: off.
No n: unlimited. |
load b
+load
-load |
Turn load tracking
on (+load or
b=1) - showing full path names - or
off (-load or
b=0), or
toggle state (just load). |
nan b
+nan
-nan |
Turn
on (+nan or
b=1) or
off (-nan or
b=0) or
toggle (just nan)
the checking of files as they are beamed in for NaN and Inf. If checking is
on and such an undesirable is found in a file being beamed in, an error message is sent
to stdout. Cf.
_nanfind. |
pack b
+pack
-pack |
Turn packfile command tracing
on (+pcb or
b=1) or
off (-pcb or
b=0), or
toggle state (just pcb). |
pcb b
+pcb
-pcb |
Turn preset-callback tracing
on (+pcb or
b=1) or
off (-pcb or
b=0), or
toggle state (just pcb). |
_prcb b
+_prcb
-_prcb |
Turn prereference-callback tracing
on (+_prcb or
b=1) or
off (-_prcb or
b=0), or
toggle state (just _prcb). |
print b
+print
-print |
Display tracing messages
(+print or
b=1) or not
(-print or
b=0), or
toggle (just print).
The default is to display them. Designed to be used in conjunction with callbacks, which
are set using
_dbg{`cb;(fn;cd)}. |
_rcb b
+_rcb
-_rcb |
Turn reference-callback tracing
on (+_rcb or
b=1) or
off (-_rcb or
b=0), or
toggle state (just _rcb). |
scb b
+scb
-scb |
Turn set-callback tracing
on (+scb or
b=1) or
off (-scb or
b=0), or
toggle state (just scb). |
sfs b
+sfs
-sfs |
Turn system function tracing
on (+sfs or
b=1) or
off (-sfs or
b=0), or
toggle state (just sfs). |
tkerr b
+tkerr
-tkerr |
Turn reporting of otherwise silent execution errors that do not cause execution
suspension
on (+tkerr or
b=1) or
off (-tkerr or
b=0), or
toggle state (just tkerr). ("tk" is
for toolkit.) The default is 0. |
wa b |
Turn tracing of $wa on or off, or toggle. Will also
trace _wa and workspace size changes by û
soon. |
xeq b
+xeq
-xeq |
Turn Execute (Protected or not) tracing
on (+xeq or
b=1) or
off (-xeq or
b=0), or
toggle state (just xeq). |
xfs b
+xfs
-xfs |
Turn external function tracing
on (+xfs or
b=1) or
off (-xfs or
b=0), or
toggle state (just xfs). |