.TH lockbyproc.d 1m "May 16, 2005" "version 1.00" "USER COMMANDS" .SH NAME lockbyproc.d \- lock time by process name. Uses DTrace. .SH SYNOPSIS .B lockbyproc.d .SH DESCRIPTION lockbyproc.d is a DTrace OneLiner to a report the total time threads have spent blocked on adaptive mutexes, by process name. Docs/oneliners.txt and Docs/Examples/oneliners_examples.txt in the DTraceToolkit contain this as a oneliner that can be cut-n-paste to run. Since this uses DTrace, only the root user or users with the dtrace_kernel privilege can run this command. .SH EXAMPLES .TP This samples until Ctrl\-C is hit. # .B lockbyproc.d .PP .SH FIELDS .TP first field This is the process name. There may be several PIDs that have the same process name, for example with numerous instances of "bash". The value reported will be the sum of them all. .TP second field This is the total length of time blocked, in nanoseconds. .PP .SH DOCUMENTATION See the DTraceToolkit for further documentation under the Docs directory. The DTraceToolkit docs may include full worked examples with verbose descriptions explaining the output. .SH EXIT lockbyproc.d will sample until Ctrl\-C is hit. .SH AUTHOR Brendan Gregg [Sydney, Australia] .SH SEE ALSO lockstat(1M), dtrace(1M)