0f58e47551
exportfs -d logs 9p traffic to /tmp/exportdb. -f allows writing to a different file. exportfs silently continues if it doesn't have permissions to create or write to /tmp/exportdb. These are poor behaviors. A better default is to write to stderr, since it is 9P debug info that is better immediately printed, and not user info that is better handled by syslog(). As a result, -f is obsolete and thus removed. Redirect responsibility is now on rc. As a side effect, rc will fail if it doesn't have permissions to write. exportfs(4) is updated to reflect all changes and with a better Synopsis. oexportfs is changed to match exportfs. oexportfs(4) is updated to reflect all changes. The Synopsis is not changed due to the number of flags. Removed -f from iostats. iostats(4) is updated to reflect all changes. ---
85 lines
1.8 KiB
Plaintext
85 lines
1.8 KiB
Plaintext
.TH IOSTATS 4
|
|
.SH NAME
|
|
iostats \- file system to measure I/O
|
|
.SH SYNOPSIS
|
|
.B iostats
|
|
[
|
|
.B -d
|
|
] [
|
|
.B -C
|
|
]
|
|
.I cmd
|
|
[
|
|
.I args...
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Iostats
|
|
is a user-level 9P filter that interposes itself between a program
|
|
and the regular file server, which
|
|
allows it to gather statistics of file system
|
|
use at the level of the Plan 9 file system protocol, 9P.
|
|
After a program
|
|
exits a report is printed on standard error.
|
|
.PP
|
|
The report consists of three sections.
|
|
The first section reports the amount
|
|
of user data in
|
|
.B read
|
|
and
|
|
.B write
|
|
messages sent by the program and the average rate at
|
|
which the data was transferred.
|
|
The
|
|
.B protocol
|
|
line reports the amount
|
|
of data sent as message headers, that is,
|
|
protocol overhead.
|
|
The
|
|
.B rpc
|
|
line reports the
|
|
total number of file system transactions.
|
|
.PP
|
|
The second section gives
|
|
the number of messages, the fastest, slowest, and average turn around
|
|
time and the amount of data involved with each 9P
|
|
message type.
|
|
The final section gives an I/O summary for each file used
|
|
by the program in terms of opens, reads and writes.
|
|
.PP
|
|
If the
|
|
.B -d
|
|
flag is present, a debugging log including all 9P traffic
|
|
is written to standard error.
|
|
.PP
|
|
The
|
|
.B -C
|
|
flag sets the MCACHE flag on the mount which allows
|
|
the kernel to cache (see
|
|
.IR bind (1)).
|
|
.SH EXAMPLE
|
|
Display summary of file I/O incurred by
|
|
.IR ls (1):
|
|
.IP
|
|
.EX
|
|
iostats ls
|
|
.EE
|
|
.PP
|
|
Start a new shell, displaying all 9P traffic caused by the shell or its children:
|
|
.IP
|
|
.EX
|
|
iostats -d rc
|
|
.EE
|
|
.SH SOURCE
|
|
.B /sys/src/cmd/iostats.c
|
|
.SH SEE ALSO
|
|
.IR dup (3),
|
|
.IR exportfs (4)
|
|
.SH BUGS
|
|
Poor clock resolution means that large amounts of I/O must be done to
|
|
get accurate rate figures.
|
|
.PP
|
|
Can be fooled by programs that do fresh mounts outside its purview,
|
|
or by the use of names of files with content that can vary by process (e.g.,
|
|
.LR #d ,
|
|
.LR /dev/cons ).
|