cpudists - CPU distrib. by Kernel/Idle/Process. Uses DTrace. cpudists [-ahV] [-t top] [interval [count]] cpudists prints the CPU time distributions consumed by the Kernel, Idle threads and by Processes. This program is a variant on cputimes, and creates extra kernel load as described in cputimes(1M). cpudists prints out a distribution report (a quantize aggregation), such that the number of occurrences and duration of each thread using the CPUs can be identified. Since this uses DTrace, only the root user or users with the dtrace_kernel privilege can run this command. Solaris stable - needs the sysinfo and sched providers.

-a print all processes

-T print totals

-V don't print timestamps

-t num print top num lines only

Default, print Kernel/Idle/Process time, 1 x 1 second sample, # cpudists

Print every 1 second, # cpudists 1

Print all processes every 10 seconds, # cpudists -a 10

Print top 8 lines every 5 seconds, # cpudists -at 8 5

IDLE Idle time - CPU running idle thread

KERNEL Kernel time - Kernel servicing interrupts, ...

PROCESS Process time - PIDs running on the system

value Time in nanoseconds

count Number of occurrences that were at least this duration (ns)

See the DTraceToolkit for further documentation under the Docs directory. The DTraceToolkit docs may include full worked examples with verbose descriptions explaining the output. cpudists will run once, unless a count is specified. Brendan Gregg [Sydney, Australia] dtrace(1M), vmstat(1M)