home | help
PLOCKSTAT(1)		     General Commands Manual		    PLOCKSTAT(1)

NAME
     plockstat -- Trace pthread lock statistics using DTrace

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

DESCRIPTION
     The plockstat utility traces pthread locks (mutexes and rwlocks) and prints
     statistics about them.  You can use plockstat to investigate bottlenecks in
     your software.

     The following options are available:

     -v      Be verbose.

     -A      Print all statistics.

     -C      Print commulative statistics (the default).

     -H      Print a histogram.

     -V      Print the DTrace script about to be used to stderr.

     -n count
	     Set the aggregation count for the data set.

     -s depth
	     Set the ustack (userland stack) caller depth.

     -e secs
	     Does nothing at the moment.

     -x opt=val
	     Specify  DTrace  options.	 See the dtrace(1) man page for more de-
	     tails.

EXIT STATUS
     The plockstat utility exits 0 on success, and >0 if an error occurs.

SEE ALSO
     dtrace(1), pthread(3)

HISTORY
     The plockstat utility comes from OpenSolaris and was  first  imported  into
     FreeBSD 9.0.

FreeBSD 15.1		       September 13, 2010		    PLOCKSTAT(1)

home | help