plockstat(1)

plockstat1

Trace pthread lock statistics using dtrace

Usage

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

Overview

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.

Releases

25 releases since FreeBSD 11.0-RELEASE; the text changed 12 times.

  1. 11.0
  2. 11.1
  3. 11.2
  4. 11.3
  5. 11.4
  6. 12.0
  7. 12.1
  8. 12.2
  9. 12.3
  10. 12.4
  11. 13.0–13.2
  12. 13.3–15.1
  13. 16.0

History

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

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.