diff options
Diffstat (limited to 'usr/src/man/man1m/vfsstat.1m')
| -rw-r--r-- | usr/src/man/man1m/vfsstat.1m | 213 |
1 files changed, 0 insertions, 213 deletions
diff --git a/usr/src/man/man1m/vfsstat.1m b/usr/src/man/man1m/vfsstat.1m deleted file mode 100644 index aef8431a09..0000000000 --- a/usr/src/man/man1m/vfsstat.1m +++ /dev/null @@ -1,213 +0,0 @@ -'\" te -.\" -.\" This file and its contents are supplied under the terms of the -.\" Common Development and Distribution License ("CDDL"), version 1.0. -.\" You may only use this file in accordance with the terms of version -.\" 1.0 of the CDDL. -.\" -.\" A full copy of the text of the CDDL should have accompanied this -.\" source. A copy of the CDDL is also available via the Internet at -.\" http://www.illumos.org/license/CDDL. -.\" -.\" Copyright 2014 Joyent, Inc. All rights reserved. -.\" -.TH "VFSSTAT" "1m" "May 1, 2014" "" "" -. -.SH "NAME" -\fBvfsstat\fR \-\- Report VFS read and write activity -. -.SH "SYNOPSIS" -. -.nf -vfsstat [\-hIMrzZ] [interval [count]] -. -.fi -. -.SH "DESCRIPTION" -The vfsstat utility reports a summary of VFS read and write -activity per zone\. It first prints all activity since boot, then -reports activity over a specified interval\. -. -.P -When run from a non\-global zone (NGZ), only activity from that NGZ -can be observed\. When run from a the global zone (GZ), activity -from the GZ and all other NGZs can be observed\. -. -.P -This tool is convenient for examining I/O performance as -experienced by a particular zone or application\. Other tools -which examine solely disk I/O do not report reads and writes which -may use the filesystem\'s cache\. Since all read and write system -calls pass through the VFS layer, even those which are satisfied -by the filesystem cache, this tool is a useful starting point when -looking at a potential I/O performance problem\. The vfsstat -command reports the most accurate reading of I/O performance as -experienced by an application or zone\. -. -.P -One additional feature is that ZFS zvol performance is also reported -by this tool, even though zvol I/O does not go through the VFS -layer\. This is done so that this single tool can be used to monitor -I/O performance and because its not unreasonable to think of zvols -as being included along with other ZFS filesystems\. -. -.P -The calculations and output fields emulate those from iostat(1m) -as closely as possible\. When only one zone is actively performing -disk I/O, the results from iostat(1m) in the global zone and -vfsstat in the local zone should be almost identical\. Note that -many VFS read operations may be handled by the filesystem cache, -so vfsstat and iostat(1m) will be similar only when most -operations require a disk access\. -. -.P -As with iostat(1m), a result of 100% for VFS read and write -utilization does not mean that the VFS layer is fully saturated\. -Instead, that measurement just shows that at least one operation -was pending over the last interval of time examined\. Since the -VFS layer can process more than one operation concurrently, this -measurement will frequently be 100% but the VFS layer can still -accept additional requests\. -. -.SH "OUTPUT" -The vfsstat utility reports the following information: -. -.IP "" 4 -. -.nf -r/s -.RS -reads per second -.RE - -w/s -.RS -writes per second -.RE - -kr/s -.RS -kilobytes read per second -.RE - -kw/s -.RS -kilobytes written per second -.RE - -ractv -.RS -average number of read operations actively being serviced by the VFS layer -.RE - -wactv -.RS -average number of write operations actively being serviced by the VFS layer -.RE - -read_t -.RS -average VFS read latency, in microseconds -.RE - -writ_t -.RS -average VFS write latency, in microseconds -.RE - -%r -.RS -percent of time there is a VFS read operation pending -.RE - -%w -.RS -percent of time there is a VFS write operation pending -.RE - -d/s -.RS -VFS operations per second delayed by the ZFS I/O throttle -.RE - -del_t -.RS -average ZFS I/O throttle delay, in microseconds -.RE -. -.fi -. -.IP "" 0 -. -.SH "OPTIONS" -The following options are supported: -. -.P -\-h -.RS -Show help message and exit -.RE -. -.P -\-I -.RS -Print results per interval, rather than per second (where applicable) -.RE -. -.P -\-M -.RS -Print results in MB/s instead of KB/s -.RE -. -.P -\-r -.RS -Show results in a comma\-separated format -.RE -. -.P -\-z -.RS -Hide zones with no VFS activity -.RE -. -.P -\-Z -.RS -Print results for all zones, not just the current zone -.RE -. -.SH "OPERANDS" -interval -. -.P -Specifies the length in seconds to pause between each interval -report\. If not specified, vfsstat will print a summary since boot -and exit\. -. -.P -count -. -.P -Specifies the number of intervals to report\. Defaults to -unlimited if not specified\. -. -.SH "SEE ALSO" -. -.nf -iostat(1m), ziostat(1m), mpstat(1m) -. -.fi -. -.SH "NOTES" -This command does not examine readdir or any other VFS operations, -only read and write operations\. -. -.P -This command does not look at network I/O, only I/O operations to -or from a file\. -. -.P -The output format from vfsstat may change over time; use the -comma\-separated output for a stable output format\. |
