1 .TH cpudists 1m "$Date:: 2007-08-05 #$" "USER COMMANDS"
3 cpudists \- CPU distrib. by Kernel/Idle/Process. Uses DTrace.
6 [\-ahV] [\-t top] [interval [count]]
8 cpudists prints the CPU time distributions consumed by the Kernel,
9 Idle threads and by Processes.
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.
16 Since this uses DTrace, only the root user or users with the
17 dtrace_kernel privilege can run this command.
21 stable - needs the sysinfo and sched providers.
31 don't print timestamps
34 print top num lines only
37 Default, print Kernel/Idle/Process time, 1 x 1 second sample,
48 Print all processes every 10 seconds,
54 Print top 8 lines every 5 seconds,
62 Idle time - CPU running idle thread
65 Kernel time - Kernel servicing interrupts, ...
68 Process time - PIDs running on the system
74 Number of occurrences that were at least this duration (ns)
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.
80 cpudists will run once, unless a count is specified.
85 dtrace(1M), vmstat(1M)