Technical data

Programming Features
5.15 New SDA Commands for the Spinlock Tracing Utility
5.15.5 SPL START TRACE
This command enables spinlock tracing. Table 5–5 shows the qualifiers for this
command.
Table 5–5 Qualifiers for the SPL START TRACE Command
Qualifier Meaning
/SPINLOCK=spinlock Specifies the tracing of a specific spinlock.
/NOSPINLOCK Disables spinlock tracing and does not collect any spinlock data.
If omitted, all spinlocks are traced.
/FORKLOCK=forklock Specifies the tracing of a specific forklock, for example,
/FORKLOCK=IOLOCK8 or /FORKLOCK=IPL8.
/NOFORKLOCK Disables forklock tracing and does not collect any forklock data.
If omitted, all forks are traced.
/BUFFER=pages Specifies the size of the trace buffer (in Alpha page units). It
defaults to 128 pages, which is equivalent to 1MB, if omitted.
/ACQUIRE Traces any spinlock acquisitions. This is the default.
/NOACQUIRE Ignores any spinlock acquisitions.
/RELEASE Traces any spinlock releases. This is the default.
/NORELEASE Ignores any spinlock releases.
/WAIT Traces any spinwait operations. This is the default.
/NOWAIT Ignores any spinwait operations.
/FRKDSPTH Traces all invocations of fork routines within the fork dispatcher.
This is the default.
/NOFRKDSPTH Ignores all of the /FRKDSPTH operations.
/FRKEND Traces all returns from fork routines within the fork dispatcher.
This is the default.
/NOFRKEND Ignores all of the operations of the /FRKEND qualifier.
/CPU=n Specifies the tracing of a specific CPU only, for example, /CPU=5
or /CPU=PRIMARY. By default, all CPUs are traced.
5.15.6 SPL STOP COLLECT
This command stops the spinlock collection, but does not stop spinlock tracing. It
has no qualifiers.
5.15.7 SPL STOP TRACE
This command disables spinlock tracing, but it does not deallocate the trace
buffer. It has no qualifiers.
5.15.8 SPL UNLOAD
This command unloads and cleans up the SPL$DEBUG execlet. Tracing is
automatically disabled and the trace buffer deallocated. It has no qualifiers.
For more information, refer to the OpenVMS Alpha System Analysis Tools
Manual.
5–26 Programming Features