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

   1 .TH cswstat.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 cswstat.d \- context switch time stats. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B cswstat.d
   6 .SH DESCRIPTION
   7 cswstat.d is a DTrace program to print context switch time
   8 statistics.
   9
  10 This program measures the time consumed during context switching,
  11 and prints it with the number of context switches and the average
  12 time.
  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 sched provider.
  20 .SH EXAMPLES
  21 .TP
  22 Print statistics every second,
  23 #
  24 .B cswstat.d
  25 .PP
  26 .SH FIELDS
  27 .TP
  28 TIME
  29 The current time
  30 .TP
  31 NUM
  32 Number of context switches in this sample
  33 .TP
  34 CSWTIME
  35 Total time consumed context switching, us
  36 .TP
  37 AVGTIME
  38 Average time for each context switch, us
  39 .PP
  40 .SH DOCUMENTATION
  41 See the DTraceToolkit for further documentation under the
  42 Docs directory. The DTraceToolkit docs may include full worked
  43 examples with verbose descriptions explaining the output.
  44 .SH EXIT
  45 cswstat.d will run forever until Ctrl\-C is hit.
  46 .SH AUTHOR
  47 Brendan Gregg
  48 [Sydney, Australia]
  49 .SH SEE ALSO
  50 mpstat(1M), dtrace(1M)
  51