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-p6 September 13, 2010 FreeBSD 14.0-RELEASE-p6