diff options
Diffstat (limited to 'usr/src/man/man1m/iostat.1m')
| -rw-r--r-- | usr/src/man/man1m/iostat.1m | 113 |
1 files changed, 18 insertions, 95 deletions
diff --git a/usr/src/man/man1m/iostat.1m b/usr/src/man/man1m/iostat.1m index ad954aba89..e45ceff5e3 100644 --- a/usr/src/man/man1m/iostat.1m +++ b/usr/src/man/man1m/iostat.1m @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH iostat 1M "23 Mar 2009" "SunOS 5.11" "System Administration Commands" +.TH IOSTAT 1M "Mar 23, 2009" .SH NAME iostat \- report I/O statistics .SH SYNOPSIS @@ -67,45 +67,37 @@ For more general system statistics, use \fBsar\fR(1), \fBsar\fR(1M), or The output of the \fBiostat\fR utility includes the following information. .sp .ne 2 -.mk .na \fB\fBdevice\fR\fR .ad .RS 10n -.rt name of the disk .RE .sp .ne 2 -.mk .na \fB\fBr/s\fR\fR .ad .RS 10n -.rt reads per second .RE .sp .ne 2 -.mk .na \fB\fBw/s\fR\fR .ad .RS 10n -.rt writes per second .RE .sp .ne 2 -.mk .na \fB\fBkr/s\fR\fR .ad .RS 10n -.rt kilobytes read per second .sp The average I/O size during the interval can be computed from \fBkr/s\fR @@ -114,12 +106,10 @@ divided by \fBr/s\fR. .sp .ne 2 -.mk .na \fB\fBkw/s\fR\fR .ad .RS 10n -.rt kilobytes written per second .sp The average I/O size during the interval can be computed from \fBkw/s\fR @@ -128,12 +118,10 @@ divided by \fBw/s\fR. .sp .ne 2 -.mk .na \fB\fBwait\fR\fR .ad .RS 10n -.rt average number of transactions waiting for service (queue length) .sp This is the number of I/O operations held in the device driver queue waiting @@ -142,12 +130,10 @@ for acceptance by the device. .sp .ne 2 -.mk .na \fB\fBactv\fR\fR .ad .RS 10n -.rt average number of transactions actively being serviced (removed from the queue but not yet completed) .sp @@ -157,12 +143,10 @@ device. .sp .ne 2 -.mk .na \fB\fBsvc_t\fR\fR .ad .RS 10n -.rt average response time of transactions, in milliseconds .sp The \fBsvc_t\fR output reports the overall \fBresponse\fR time, rather than the @@ -176,56 +160,46 @@ Service time is also shown with the \fB-x\fR option and appears in the .sp .ne 2 -.mk .na \fB\fB%w\fR\fR .ad .RS 10n -.rt percent of time there are transactions waiting for service (queue non-empty) .RE .sp .ne 2 -.mk .na \fB\fB%b\fR\fR .ad .RS 10n -.rt percent of time the disk is busy (transactions in progress) .RE .sp .ne 2 -.mk .na \fB\fBwsvc_t\fR\fR .ad .RS 10n -.rt average service time in wait queue, in milliseconds .RE .sp .ne 2 -.mk .na \fB\fBasvc_t\fR\fR .ad .RS 10n -.rt average service time of active transactions, in milliseconds .RE .sp .ne 2 -.mk .na \fB\fBwt\fR\fR .ad .RS 10n -.rt the I/O wait time is no longer calculated as a percentage of \fBCPU\fR time, and this statistic will always return zero. .RE @@ -236,12 +210,10 @@ and this statistic will always return zero. The following options are supported: .sp .ne 2 -.mk .na \fB\fB-c\fR\fR .ad .RS 12n -.rt Report the percentage of time the system has spent in user mode, in system mode, waiting for \fBI/O,\fR and idling. See the NOTES section for more information. @@ -249,71 +221,59 @@ information. .sp .ne 2 -.mk .na \fB\fB-C\fR\fR .ad .RS 12n -.rt When the \fB-x\fR option is also selected, report extended disk statistics aggregated by \fIcontroller id\fR. .RE .sp .ne 2 -.mk .na \fB\fB-d\fR\fR .ad .RS 12n -.rt For each disk, report the number of kilobytes transferred per second, the number of transfers per second, and the average service time in milliseconds. .RE .sp .ne 2 -.mk .na \fB\fB-D\fR\fR .ad .RS 12n -.rt For each disk, report the reads per second, writes per second, and percentage disk utilization. .RE .sp .ne 2 -.mk .na \fB\fB-e\fR\fR .ad .RS 12n -.rt Display device error summary statistics. The total errors, hard errors, soft errors, and transport errors are displayed. .RE .sp .ne 2 -.mk .na \fB\fB-E\fR\fR .ad .RS 12n -.rt Display all device error statistics. .RE .sp .ne 2 -.mk .na \fB\fB-i\fR\fR .ad .RS 12n -.rt In \fB-E\fR output, display the \fBDevice ID\fR instead of the \fBSerial No\fR. The \fBDevice Id\fR is a unique identifier registered by a driver through \fBddi_devid_register\fR(9F). @@ -321,23 +281,19 @@ The \fBDevice Id\fR is a unique identifier registered by a driver through .sp .ne 2 -.mk .na \fB\fB-I\fR\fR .ad .RS 12n -.rt Report the counts in each interval, rather than rates (where applicable). .RE .sp .ne 2 -.mk .na \fB\fB-l\fR \fIn\fR\fR .ad .RS 12n -.rt Limit the number of disks included in the report to \fIn\fR; the disk limit defaults to 4 for \fB-d\fR and \fB-D\fR, and unlimited for \fB-x\fR. Note: disks explicitly requested (see \fIdisk\fR below) are not subject to this disk @@ -346,12 +302,10 @@ limit. .sp .ne 2 -.mk .na \fB\fB-m\fR\fR .ad .RS 12n -.rt Report file system mount points. This option is most useful if the \fB-P\fR or \fB-p\fR option is also specified or used in conjunction with \fB-Xn\fR or \fB-en\fR. The \fB-m\fR option is useful only if the mount point is actually @@ -361,23 +315,19 @@ listed in the output. This option can only be used in conjunction with the .sp .ne 2 -.mk .na \fB\fB-M\fR\fR .ad .RS 12n -.rt Display data throughput in \fBMB\fR/sec instead of KB/sec. .RE .sp .ne 2 -.mk .na \fB\fB-n\fR\fR .ad .RS 12n -.rt Display names in descriptive format. For example, \fBcXtYdZ\fR, \fBrmt/N\fR, \fBserver:/export/path\fR. .sp @@ -391,68 +341,56 @@ Name appears in the \fBt\fR field. .sp .ne 2 -.mk .na \fB\fB-p\fR\fR .ad .RS 12n -.rt For each disk, report per-partition statistics in addition to per-device statistics. .RE .sp .ne 2 -.mk .na \fB\fB-P\fR\fR .ad .RS 12n -.rt For each disk, report per-partition statistics only, no per-device statistics. .RE .sp .ne 2 -.mk .na \fB\fB-r\fR\fR .ad .RS 12n -.rt Display data in a comma-separated format. .RE .sp .ne 2 -.mk .na \fB\fB-s\fR\fR .ad .RS 12n -.rt Suppress messages related to \fBstate changes\fR. .RE .sp .ne 2 -.mk .na \fB\fB-t\fR\fR .ad .RS 12n -.rt Report the number of characters read and written to terminals per second. .RE .sp .ne 2 -.mk .na \fB\fB-T\fR u | d\fR .ad .RS 12n -.rt Display a time stamp. .sp Specify \fBu\fR for a printed representation of the internal representation of @@ -462,24 +400,20 @@ time. See \fBtime\fR(2). Specify \fBd\fR for standard date format. See .sp .ne 2 -.mk .na \fB\fB-X\fR\fR .ad .RS 12n -.rt For disks under \fBscsi_vhci\fR(7D) control, in addition to disk \fIlun\fR statistics, also report statistics for \fIlun\fR.\fIcontroller\fR. .RE .sp .ne 2 -.mk .na \fB\fB-x\fR\fR .ad .RS 12n -.rt Report extended disk statistics. By default, disks are identified by instance names such as \fBssd23\fR or \fBmd301\fR. Combining the \fBx\fR option with the \fB-n\fR option causes disk names to display in the \fBcXtYdZsN\fR format, more @@ -493,12 +427,10 @@ is implied. .sp .ne 2 -.mk .na \fB\fB-Y\fR\fR .ad .RS 12n -.rt For disks under \fBscsi_vhci\fR(7D) control, in addition to disk \fIlun\fR statistics, also report statistics for \fIlun\fR.\fItargetport\fR and \fIlun\fR.\fItargetport\fR.\fIcontroller\fR. @@ -515,12 +447,10 @@ is implied. .sp .ne 2 -.mk .na \fB\fB-z\fR\fR .ad .RS 12n -.rt Do not print lines whose underlying data values are all zeros. .RE @@ -534,23 +464,19 @@ determining whether disk I/O problems exist and for identifying problems. The following operands are supported: .sp .ne 2 -.mk .na \fB\fIcount\fR\fR .ad .RS 12n -.rt Display only \fIcount\fR reports. .RE .sp .ne 2 -.mk .na \fB\fIdisk\fR\fR .ad .RS 12n -.rt Explicitly specify the disks to be reported; in addition to any explicit disks, any active disks up to the disk limit (see \fB-l\fR above) will also be reported. @@ -558,12 +484,10 @@ reported. .sp .ne 2 -.mk .na \fB\fIinterval\fR\fR .ad .RS 12n -.rt Report once each \fIinterval\fR seconds. .RE @@ -588,7 +512,7 @@ Mon Nov 24 14:58:36 2003 cpu us sy wt id 14 31 0 20 - extended device statistics + extended device statistics r/s w/s kr/s kw wait actv wsvc_t asvc_t %w %b device 3.8 29.9 145.8 44.0 0.0 0.2 0.1 6.4 0 5 c0 666.3 814.8 12577.6 17591.1 91.3 82.3 61.6 55.6 0 2 c12 @@ -598,7 +522,7 @@ Mon Nov 24 14:58:41 2003 cpu us sy wt id 11 31 0 22 - extended device statistics + extended device statistics r/s w/s kr/s kw wait actv wsvc_t asvc_t %w %b device 0.8 41.0 5.2 20.5 0.0 0.2 0.2 4.4 0 6 c0 565.3 581.7 8573.2 10458.9 0.0 26.6 0.0 23.2 0 3 c12 @@ -624,18 +548,18 @@ example% \fBiostat\fR \fB-x\fR \fBtc 5 2\fR extended device statistics tty cpu device r/s w/s kr/s kw/s wait actv svc_t %w %b tin tout us sy wt id sd0 0.4 0.3 10.4 8.0 0.0 0.0 36.9 0 1 0 10 0 0 0 99 -sd1 0.0 0.0 0.3 0.4 0.0 0.0 35.0 0 0 -sd6 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 -nfs1 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 -nfs2 0.0 0.0 0.0 0.1 0.0 0.0 35.6 0 0 +sd1 0.0 0.0 0.3 0.4 0.0 0.0 35.0 0 0 +sd6 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 +nfs1 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 +nfs2 0.0 0.0 0.0 0.1 0.0 0.0 35.6 0 0 extended device statistics tty cpu device r/s w/s kr/s kw/s wait actv svc_t %w %b tin tout us sy wt id sd0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 0 155 0 0 0 100 -sd1 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 -sd6 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 -nfs1 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 -nfs2 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 - +sd1 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 +sd6 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 +nfs1 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 +nfs2 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0 0 + .fi .in -2 .sp @@ -653,7 +577,7 @@ identified by controller names. .nf example% \fBiostat -xnp\fR - extended device statistics + extended device statistics r/s w/s kr/s kw/s wait actv wsvc_t asvc_t %w %b device 0.4 0.3 10.4 7.9 0.0 0.0 0.0 36.9 0 1 c0t0d0 0.3 0.3 9.0 7.3 0.0 0.0 0.0 37.2 0 1 c0t0d0s0 @@ -712,13 +636,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilitySee below. +Interface Stability See below. .TE .sp |