System Debug Reference Manual (32650-90888)
270 Chapter6
System Debug Command Specifications M-X
TR[ACE]
reached, System Debug automatically switches to the stack of the last running process and
continues the stack trace. This feature in no way implies that the routines on the ICS were
invoked on behalf of the last running process. If the dispatcher is currently running, there
is no last running process, so the stack trace stops when the base of the ICS is found.
Parameters
level
The desired maximum depth for the stack trace. If
level
is omitted, the
entire depth of the stack is traced.
options
Any combination of the following options may be specified:
DUAL Display both NM and CM stack markers, interleaved
across switch markers.
SINGLE Display a single stack marker at the specified level.
UNWIND Display formatted stack unwind descriptor information.
FULL Display a fully detailed stack trace.
ISM Trace across interrupt markers.
NM Examples
$nmdebug > tr
PC=115.00005b50 processstudent.highscore
* 0) SP=40221180 RP=115.00005f0c processstudent+$1e8
1) SP=40221180 RP=115.00006b1c PROGRAM+$300
2) SP=40221100 RP=115.00000000
(end of NM stack)
Display an entire NM stack trace. The first line indicates the address the PC register
points to. Each stack level is formatted, starting from the top of stack and working down
the depth of the stack. Level numbers are indicated on the left; an asterisk marks the
current level. (Refer to the LEV command.)
$nmdebug > tr
PC=a.0074da24 FWRITE
* 0) SP=40221260 RP=a.00748150 ?FWRITE+$8
export stub: f4.0012d044 P_FLUSHLINE+$54
1) SP=40221260 RP=f4.00139560 P_WRITELN+$20
2) SP=40221200 RP=f4.00139630 P_WRITELN+$9c
3) SP=402211c8 RP=f4.0013950c ?P_WRITELN+$8
export stub: 115.00005e30 processstudent+$10c
4) SP=40221180 RP=115.00006b1c PROGRAM+$300
5) SP=40221100 RP=115.00000000
(end of NM stack)
The above example shows a stack trace that contains a call from the program file to a user
library, and from the user library to the system NL. Transitions between libraries are
performed through the use of export stubs. (Refer to the Procedure Calling Conventions
Reference Manual (09740-90015) for a description of export stubs.)
$nmdebug > tr,unw
PC=115.00005b50 processstudent.highscore