plockstat(8) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

plockstat(8)

plockstat(8)            System Administration Commands            plockstat(8)

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 locking statis‐
       tics. By default, plockstat monitors all lock contention events,  gath‐
       ers 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 mea‐
       surable performance overhead on the  processes  being  observed.  Users
       must  have  the  dtrace_proc privilege and have permission to observe a
       particular process with plockstat. Refer to  the  Oracle  Solaris  11.4
       DTrace  (Dynamic Tracing) Guide for more information about DTrace secu‐
       rity 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.


       -s depth        Record a stack trace rather than just the calling func‐
                       tion.


       -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 Oracle  So‐
                       laris  11.4 DTrace (Dynamic Tracing) Guide. Boolean op‐
                       tions 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(8)
                       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 monitored.


       secs       Duration specified as a positive integer number of seconds.


DISPLAY HEADERS
       The following headers appear over columns of data in plockstat output.

       Count

           Number of times an event occurred.


       nsec

           Average duration of an event, in nanoseconds.


       Lock

           Address of a lock, displayed symbolically if possible.


       Caller

           Address of a caller, displayed symbolically if possible.


EXIT STATUS
       The following exit values are returned:

       0     Successful completion.


       >0    An error occurred.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE _ Availabilitysystem/dtrace _ Interface StabilitySee be‐
       low.



       The command-line syntax is Committed. The human-readable output is  Un‐
       committed.

SEE ALSO
       mutex_init(3C),    pthread_mutex_lock(3C),   pthread_rwlock_rdlock(3C),
       pthread_rwlock_unlock(3C), pthread_rwlock_wrlock(3C), rwlock(3C), fast‐
       trap(4D), attributes(7), dtrace(8), lockstat(8)


       Oracle Solaris 11.4 DTrace (Dynamic Tracing) Guide

Oracle Solaris 11.4               16 Aug 2011                     plockstat(8)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3