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

   1 .TH runocc.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 runocc.d \- run queue occupancy by CPU. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B runocc.d
   6 .SH DESCRIPTION
   7 This prints the dispatcher run queue occupancy by CPU each second.
   8 A consistant run queue occupancy is a sign of CPU saturation.
   9
  10 The value is similar to that seen in "sar -q", however this is
  11 calculated in a more accurate manner - sampling at 1000 Hertz.
  12
  13 Since this uses DTrace, only the root user or users with the
  14 dtrace_kernel privilege can run this command.
  15 .SH OS
  16 Solaris
  17 .SH STABILITY
  18 stable.
  19 .SH EXAMPLES
  20 .TP
  21 Print %runocc by CPU every second,
  22 #
  23 .B runocc.d
  24 .PP
  25 .SH FIELDS
  26 .TP
  27 CPU
  28 cpu ID
  29 .TP
  30 %runocc
  31 percent run queue occupancy, sampled at 1000 Hertz
  32 .PP
  33 .SH SEE ALSO
  34 Solaris Internals 2nd Ed, vol 2, CPU chapter
  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 runocc.d will sample until Ctrl\-C is hit.
  42 .SH AUTHOR
  43 Brendan Gregg
  44 [Sydney, Australia]
  45 .SH SEE ALSO
  46 dtrace(1M)