cddl/contrib/dtracetoolkit/Man/man1m/lockbyproc.d.1m

   1 .TH lockbyproc.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 lockbyproc.d \- lock time by process name. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B lockbyproc.d
   6 .SH DESCRIPTION
   7 lockbyproc.d is a DTrace OneLiner to a report the total time threads
   8 have spent blocked on adaptive mutexes, by process name.
   9
  10 Docs/oneliners.txt and Docs/Examples/oneliners_examples.txt
  11 in the DTraceToolkit contain this as a oneliner that can be cut-n-paste
  12 to run.
  13
  14 Since this uses DTrace, only the root user or users with the
  15 dtrace_kernel privilege can run this command.
  16 .SH OS
  17 Solaris
  18 .SH STABILITY
  19 stable - needs the lockstat provider.
  20 .SH EXAMPLES
  21 .TP
  22 This samples until Ctrl\-C is hit.
  23 #
  24 .B lockbyproc.d
  25 .PP
  26 .SH FIELDS
  27 .TP
  28 first field
  29 This is the process name. There may be several PIDs that have the
  30 same process name, for example with numerous instances of "bash". The
  31 value reported will be the sum of them all.
  32 .TP
  33 second field
  34 This is the total length of time blocked, in nanoseconds.
  35 .PP
  36 .SH DOCUMENTATION
  37 See the DTraceToolkit for further documentation under the
  38 Docs directory. The DTraceToolkit docs may include full worked
  39 examples with verbose descriptions explaining the output.
  40 .SH EXIT
  41 lockbyproc.d will sample until Ctrl\-C is hit.
  42 .SH AUTHOR
  43 Brendan Gregg
  44 [Sydney, Australia]
  45 .SH SEE ALSO
  46 lockstat(1M), dtrace(1M)
  47