1 .TH pfilestat 1m "$Date:: 2007-08-05 #$" "USER COMMANDS"
3 pfilestat \- show I/O latency break down by FD. Uses DTrace.
5 .B pfilestat [\-r|\-w] pid
7 This prints I/O statistics for each file descriptor within a process.
8 In particular, the time break down during read() and write() events is
11 Since this uses DTrace, only the root user or users with the
12 dtrace_kernel privilege can run this command.
16 unstable - this script uses fbt provider probes which may change for
17 future updates of the OS, invalidating this script. Please read
18 Docs/Notes/ALLfbt_notes.txt for further details about these fbt scripts.
32 Sample both read and write activity for PID 81,
36 Sample reads only for PID 81,
44 microstate. see STATES below.
50 percentage of wallclock time in each STATE
53 Name of file, if known
58 Time spent during the execution of the read() syscall.
61 Time spent during the execution of the write() syscall.
64 Latency spent waiting to be scheduled after becoming runnable.
67 Process running user-mode code.
70 Process sleeping on reads.
73 Process sleeping on writes.
76 pfilestat is discussed and demonstrated in Solaris Internals 2nd edition,
79 See the DTraceToolkit for further documentation under the
80 Docs directory. The DTraceToolkit docs may include full worked
81 examples with verbose descriptions explaining the output.
83 pfilestat will sample until Ctrl\-C is hit.