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

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