.TH readdist.d 1m "May 15, 2005" "version 1.00" "USER COMMANDS" .SH NAME readdist.d \- read distrib. by process name. Uses DTrace. .SH SYNOPSIS .B readdist.d .SH DESCRIPTION readdist.d is a DTrace OneLiner to a report the read size and number of occurrences as a frequency distribution by process name. This can be useful to identify the behaviour of processes that are doing reads. Are they using many small reads, or fewer large reads. Docs/oneliners.txt and Docs/Examples/oneliners_examples.txt in the DTraceToolkit contain this as a oneliner that can be cut-n-paste to run. Since this uses DTrace, only the root user or users with the dtrace_kernel privilege can run this command. .SH EXAMPLES .TP This samples until Ctrl\-C is hit. # .B readdist.d .PP .SH FIELDS .TP process name The process name. There may be several PIDs that have the same process name, for example with numerous instances of "bash". The value reported will be the sum of them all. .TP value The size in bytes .TP count The number of occurrences that were at least this size .PP .SH DOCUMENTATION See the DTraceToolkit for further documentation under the Docs directory. The DTraceToolkit docs may include full worked examples with verbose descriptions explaining the output. .SH EXIT readdist.d will sample until Ctrl\-C is hit. .SH AUTHOR Brendan Gregg [Sydney, Australia] .SH SEE ALSO dtrace(1M), truss(1)