55 lines
1.4 KiB
Plaintext
55 lines
1.4 KiB
Plaintext
.TH readdist.d 1m "$Date:: 2007-08-05 #$" "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 OS
|
|
Solaris
|
|
.SH STABILITY
|
|
stable - needs the sysinfo provider.
|
|
.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)
|
|
|