System Administration Commands                      plockstat(1M)



NAME
     plockstat - report user-level lock statistics

SYNOPSIS
     plockstat [-vACHV] [-n count] [-s depth] [-e secs]
          [-x arg [=val] command [arg]...


     plockstat [-vACHV] [-n count] [-s depth] [-e secs]
          [-x arg [=val] -p pid


DESCRIPTION
     The plockstat utility gathers and displays user-level  lock-
     ing statistics. By default, plockstat monitors all lock con-
     tention events, gathers  frequency  and  timing  data  about
     those  events, and displays the data in decreasing frequency
     order, so that the most common events appear first.


     plockstat gathers data until the specified command completes
     or the process specified with the -p option completes.


     plockstat relies on DTrace to instrument a  running  process
     or  a  command  it invokes to trace events of interest. This
     imposes a small but measurable performance overhead  on  the
     processes  being  observed.  Users must have the dtraceproc
     privilege and have permission to observe a  particular  pro-
     cess  with  plockstat.  Refer  to  the  for more information
     about DTrace security features.

OPTIONS
     The following options are supported:

     -A              Watch  all  lock  events.  This  option   is
                     equivalent to -CH.


     -C              Watch contention events.


     -H              Watch hold events.


     -e secs         Exit after the number of  seconds  specified
                     have elapsed.


     -n count        Display only the specified number of entries
                     for each output category.




SunOS 5.11          Last change: 26 Jan 2009                    1






System Administration Commands                      plockstat(1M)



     -s depth        Record a stack trace rather  than  just  the
                     calling function.


     -p pid          Specify a process ID from which plockstat is
                     to gather data.


     -v              Print out a message to indicate that tracing
                     has started.


     -x arg[=val]    Enable or modify a DTrace runtime option  or
                     D  compiler  option.  The list of options is
                     found in the Solaris Dynamic Tracing  Guide.
                     Boolean  options  are  enabled by specifying
                     their name. Options with values are  set  by
                     separating the option name and value with an
                     equals sign (=).


     -V              Print the Dtrace commands used to gather the
                     data.  The  output can then be used directly
                     with the dtrace(1M) command.


OPERANDS
     The following operands are supported:

     arg        A string to be passed as an argument to command.


     command    The name of a utility to be invoked.


     count      A positive integer value.


     pid        A process identifier for a process  to  be  moni-
                tored.


     secs       Duration specified as a positive  integer  number
                of seconds.


EXIT STATUS
     The following exit values are returned:

     0     Successful completion.





SunOS 5.11          Last change: 26 Jan 2009                    2






System Administration Commands                      plockstat(1M)



     >0    An error occurred.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWdtrc                    
    
     Interface Stability          See below.                  
    



     The command-line syntax is Evolving. The human-readable out-
     put is Unstable.

SEE ALSO
     dtrace(1M),          lockstat(1M),           mutexinit(3C),
     pthreadmutexlock(3C),           pthreadrwlockrdlock(3C),
     pthreadrwlockwrlock(3C),        pthreadrwlockunlock(3C),
     rwlock(3C), attributes(5), fasttrap(7D)

























SunOS 5.11          Last change: 26 Jan 2009                    3