FreeBSD manual
download PDF document: plockstat.1.pdf
PLOCKSTAT(1) FreeBSD 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
details.
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 14.0-RELEASE-p11 September 13, 2010 FreeBSD 14.0-RELEASE-p11