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

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