Technical data

Programming Features
5.15 New SDA Commands for the Spinlock Tracing Utility
5.15.3 SPL SHOW TRACE
This command displays spinlock tracing information. Table 5–3 shows the
qualifiers for this command.
Table 5–3 Qualifiers for the SPL SHOW TRACE Command
Qualifier Meaning
/SPINLOCK=spinlock Specifies the display of a specific spinlock, for example,
/SPINLOCK=LCKMGR or /SPINLOCK=SCHED.
/NOSPINLOCK Specifies that no spinlock trace information be displayed. If
omitted, all spinlock trace entries are decoded and displayed.
/FORKLOCK=forklock Specifies the display of a specific forklock, for example,
/FORKLOCK=IOLOCK8 or /FORKLOCK=IPL8.
/NOFORKLOCK Specifies that no forklock trace information be displayed. If
omitted, all fork trace entries are decoded and displayed.
/ACQUIRE Displays any spinlock acquisitions.
/NOACQUIRE Ignores any spinlock acquisitions.
/RELEASE Displays any spinlock releases.
/NORELEASE Ignores any spinlock releases.
/WAIT Displays any spinwait operations.
/NOWAIT Ignores any spinwait operations.
/FRKDSPTH Displays all invocations of fork routines within the fork
dispatcher. This is the default.
/NOFRKDSPTH Ignores all of the operations of the /FRKDSPTH qualifier.
/FRKEND Displays all returns from fork routines within the fork
dispatcher. This is the default.
/NOFRKEND Ignores all operations of the /FRKEND qualifier.
/SUMMARY Stops the entire trace buffer and displays a summary of all
spinlock and forklock activity. It also displays the top ten
callers.
/CPU=n Specifies the display of information for a specific CPU only,
for example, /CPU=5 or /CPU=PRIMARY. By default, all trace
entries for all CPUs are displayed.
/TOP=n Displays a different number other than the top ten callers or
fork PC. By default, the top ten are displayed. This qualifier is
only useful when you also specify the /SUMMARY qualifier.
5.15.4 SPL START COLLECT
This command accumulates information for a specific spinlock. Table 5–4 shows
the qualifiers for this command:
Table 5–4 Qualifiers for the SPL START COLLECT Command
Qualifier Meaning
/SPINLOCK=spinlock Specifies the tracing of a specific spinlock, for example,
/SPINLOCK=LCKMGR or /SPINLOCK=SCHED
/ADDRESS=n Specifies the tracing of a specific spinlock by address
Programming Features 5–25