Library /sys$common/syshlp/SDA.HLB  —  SPL Extension, START

1  –  COLLECT

    Starts to collect spinlock information a longer period of time
    than will fit into the trace buffer.

    Format

      SPL START COLLECT  [/SPINLOCK=spinlock|/ADDRESS=n]

1.1  –  Qualifiers

1.1.1    /ADDRESS

       /ADDRESS=n

    Specifies the tracing of a specific spinlock by address.

1.1.2    /SPINLOCK

       /SPINLOCK=spinlock

    Specifies the tracing of a specific spinlock, for example,
    /SPINLOCK=LCKMGR or /SPINLOCK=SCHED.

2  –  TRACE

    Enables spinlock tracing.

    Format

      SPL START TRACE  [ /[NO]ACQUIRE | /BUFFER=pages | /CPU=n

                       | /[NO]FORKLOCK=forklock | /[NO]FRKDSPTH

                       | /[NO]FRKEND | /[NO]RELEASE

                       | /[NO]SPINLOCK=spinlock | /[NO]WAIT ]

2.1  –  Qualifiers

2.1.1    /ACQUIRE

       /ACQUIRE
       /NOACQUIRE

    The /ACQUIRE qualifier traces any spinlock acquisitions. This is
    the default.

    The /NOACQUIRE qualifier ignores any spinlock acquisitions.

2.1.2    /BUFFER

       /BUFFER=pages

    Specifies the size of the trace buffer (in page units). It
    defaults to 128 pages, which is equivalent to 1MB, if omitted.

2.1.3    /CPU

       /CPU=n

    Specifies the tracing of a specific CPU only, for example, /CPU=5
    or /CPU=PRIMARY. By default, all CPUs are traced.

2.1.4    /FORKLOCK

       /FORKLOCK=forklock
       /NOFORKLOCK

    The /FORKLOCK=forklock qualifier specifies the tracing of
    a specific forklock, for example, /FORKLOCK=IOLOCK8 or
    /FORKLOCK=IPL8.

    The /NOFORKLOCK qualifier disables forklock tracing and does not
    collect any forklock data. By default, all forks are traced.

2.1.5    /FRKDSPTH

       /FRKDSPTH
       /NOFRKDSPTH

    The /FRKDSPTH qualifier traces all invocations of fork routines
    within the fork dispatcher. This is the default.

    The /NOFRKDSPTH qualifier ignores all of the /FRKDSPTH
    operations.

2.1.6    /FRKEND

       /FRKEND
       /NOFRKEND

    The /FRKEND qualifier traces all returns from fork routines
    within the fork dispatcher. This is the default.

    The /NOFRKEND qualifier ignores all of the operations of the
    /FRKEND qualifier.

2.1.7    /RELEASE

       /RELEASE
       /NORELEASE

    The /RELEASE qualifier traces any spinlock releases. This is the
    default.

    The /NORELEASE qualifier ignores any spinlock releases.

2.1.8    /SPINLOCK

       /SPINLOCK=spinlock
       /NOSPINLOCK

    The /SPINLOCK=spinlock qualifier specifies the tracing
    of a specific spinlock, for example, /SPINLOCK=LCKMGR or
    /SPINLOCK=SCHED.

    The /NOSPINLOCK qualifier disables spinlock tracing and does not
    collect any spinlock data. By default, all spinlocks are traced.

2.1.9    /WAIT

       /WAIT
       /NOWAIT

    The /WAIT qualifier traces any spinwait operations. This is the
    default.

    The /NOWAIT qualifier ignores any spinwait operations.
Close Help