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

개요

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

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
                       Solaris 11.4 DTrace (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(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
       below.



       The  command-line  syntax  is  Committed.  The human-readable output is
       Uncommitted.

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