cddl/contrib/dtracetoolkit/Man/man1m/cpudists.1m

   1 .TH cpudists 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 cpudists \- CPU distrib. by Kernel/Idle/Process. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B cpudists
   6 [\-ahV] [\-t top] [interval [count]]
   7 .SH DESCRIPTION
   8 cpudists prints the CPU time distributions consumed by the Kernel,
   9 Idle threads and by Processes.
  10
  11 This program is a variant on cputimes, and creates extra kernel load as
  12 described in cputimes(1M). cpudists prints out a distribution report
  13 (a quantize aggregation), such that the number of occurrences and
  14 duration of each thread using the CPUs can be identified.
  15
  16 Since this uses DTrace, only the root user or users with the
  17 dtrace_kernel privilege can run this command.
  18 .SH OS
  19 Solaris
  20 .SH STABILITY
  21 stable - needs the sysinfo and sched providers.
  22 .SH OPTIONS
  23 .TP
  24 \-a
  25 print all processes
  26 .TP
  27 \-T
  28 print totals
  29 .TP
  30 \-V
  31 don't print timestamps
  32 .TP
  33 \-t num
  34 print top num lines only
  35 .SH EXAMPLES
  36 .TP
  37 Default, print Kernel/Idle/Process time, 1 x 1 second sample,
  38 #
  39 .B cpudists
  40 .PP
  41 .TP
  42 Print every 1 second,
  43 #
  44 .B cpudists
  45 1
  46 .PP
  47 .TP
  48 Print all processes every 10 seconds,
  49 #
  50 .B cpudists
  51 \-a 10
  52 .PP
  53 .TP
  54 Print top 8 lines every 5 seconds,
  55 #
  56 .B cpudists
  57 \-at 8 5
  58 .PP
  59 .SH FIELDS
  60 .TP
  61 IDLE
  62 Idle time - CPU running idle thread
  63 .TP
  64 KERNEL
  65 Kernel time - Kernel servicing interrupts, ...
  66 .TP
  67 PROCESS
  68 Process time - PIDs running on the system
  69 .TP
  70 value
  71 Time in nanoseconds
  72 .TP
  73 count
  74 Number of occurrences that were at least this duration (ns)
  75 .SH DOCUMENTATION
  76 See the DTraceToolkit for further documentation under the
  77 Docs directory. The DTraceToolkit docs may include full worked
  78 examples with verbose descriptions explaining the output.
  79 .SH EXIT
  80 cpudists will run once, unless a count is specified.
  81 .SH AUTHOR
  82 Brendan Gregg
  83 [Sydney, Australia]
  84 .SH SEE ALSO
  85 dtrace(1M), vmstat(1M)
  86