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

   1 .TH fddist 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 fddist \- file descriptor usage distributions. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B fddist [\-r|\-w]
   6 .SH DESCRIPTION
   7 This prints distributions for read and write events by file descriptor,
   8 by process. This can be used to determine which file descriptor a
   9 process is doing the most I/O with.
  10
  11 Since this uses DTrace, only the root user or users with the
  12 dtrace_kernel privilege can run this command.
  13 .SH OS
  14 Solaris
  15 .SH STABILITY
  16 stable - needs the syscall provider.
  17 .SH OPTIONS
  18 .TP
  19 \-r
  20 reads only
  21 .TP
  22 \-w
  23 writes only
  24 .PP
  25 .SH EXAMPLES
  26 .TP
  27 Sample both read and write activity,
  28 #
  29 .B fddist
  30 .TP
  31 Sample reads only,
  32 #
  33 .B fddist
  34 \-r
  35 .PP
  36 .SH FIELDS
  37 .TP
  38 EXEC
  39 process name
  40 .TP
  41 PID
  42 process ID
  43 .TP
  44 value
  45 file descriptor
  46 .TP
  47 count
  48 number of events
  49 .PP
  50 .SH BASED ON
  51 /usr/demo/dtrace/lquantize.d
  52 .PP
  53 .SH DOCUMENTATION
  54 DTrace Guide "Aggregations" chapter (docs.sun.com)
  55
  56 See the DTraceToolkit for further documentation under the
  57 Docs directory. The DTraceToolkit docs may include full worked
  58 examples with verbose descriptions explaining the output.
  59 .SH EXIT
  60 fddist will sample until Ctrl\-C is hit.
  61 .SH SEE ALSO
  62 dtrace(1M)
  63