11 .\" See the License for the specific language governing permissions
12 .\" and limitations under the License.
13 .\"
14 .\" When distributing Covered Code, include this CDDL HEADER in each
15 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 .\" If applicable, add the following below this CDDL HEADER, with the
17 .\" fields enclosed by brackets "[]" replaced with your own identifying
18 .\" information: Portions Copyright [yyyy] [name of copyright owner]
19 .\"
20 .\" CDDL HEADER END
21 .\"
22 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights reserved
23 .\" Copyright (c) 2012 by Delphix. All rights reserved.
24 .\"
25 .TH IOSTAT 1M "Mar 23, 2009"
26 .SH NAME
27 iostat \- report I/O statistics
28 .SH SYNOPSIS
29 .LP
30 .nf
31 \fB/usr/bin/iostat\fR [\fB-cCdDeEiImMnpPrstxXYz\fR] [\fB-l\fR \fIn\fR] [\fB-T\fR u | d]
32 [\fIdisk\fR]... [\fIinterval\fR [\fIcount\fR]]
33 .fi
34
35 .SH DESCRIPTION
36 .sp
37 .LP
38 The \fBiostat\fR utility iteratively reports terminal, disk, and tape \fBI/O\fR
39 activity, as well as \fBCPU\fR utilization. The first line of output is for all
40 time since boot; each subsequent line is for the prior interval only.
41 .sp
42 .LP
43 To compute this information, the kernel maintains a number of counters. For
44 each disk, the kernel counts reads, writes, bytes read, and bytes written. The
45 kernel also takes hi-res time stamps at queue entry and exit points, which
46 allows it to keep track of the residence time and cumulative residence-length
47 product for each queue. Using these values, \fBiostat\fR produces highly
48 accurate measures of throughput, utilization, queue lengths, transaction rates
49 and service time. For terminals collectively, the kernel simply counts the
50 number of input and output characters.
51 .sp
350
351 .sp
352 .ne 2
353 .na
354 \fB\fB-p\fR\fR
355 .ad
356 .RS 12n
357 For each disk, report per-partition statistics in addition to per-device
358 statistics.
359 .RE
360
361 .sp
362 .ne 2
363 .na
364 \fB\fB-P\fR\fR
365 .ad
366 .RS 12n
367 For each disk, report per-partition statistics only, no per-device statistics.
368 .RE
369
370 .sp
371 .ne 2
372 .na
373 \fB\fB-r\fR\fR
374 .ad
375 .RS 12n
376 Display data in a comma-separated format.
377 .RE
378
379 .sp
380 .ne 2
381 .na
382 \fB\fB-s\fR\fR
383 .ad
384 .RS 12n
385 Suppress messages related to \fBstate changes\fR.
386 .RE
387
388 .sp
389 .ne 2
|
11 .\" See the License for the specific language governing permissions
12 .\" and limitations under the License.
13 .\"
14 .\" When distributing Covered Code, include this CDDL HEADER in each
15 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 .\" If applicable, add the following below this CDDL HEADER, with the
17 .\" fields enclosed by brackets "[]" replaced with your own identifying
18 .\" information: Portions Copyright [yyyy] [name of copyright owner]
19 .\"
20 .\" CDDL HEADER END
21 .\"
22 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights reserved
23 .\" Copyright (c) 2012 by Delphix. All rights reserved.
24 .\"
25 .TH IOSTAT 1M "Mar 23, 2009"
26 .SH NAME
27 iostat \- report I/O statistics
28 .SH SYNOPSIS
29 .LP
30 .nf
31 \fB/usr/bin/iostat\fR [\fB-cCdDeEiImMnpPfFrstxXYz\fR] [\fB-l\fR \fIn\fR] [\fB-T\fR u | d]
32 [\fIdisk\fR]... [\fIinterval\fR [\fIcount\fR]]
33 .fi
34
35 .SH DESCRIPTION
36 .sp
37 .LP
38 The \fBiostat\fR utility iteratively reports terminal, disk, and tape \fBI/O\fR
39 activity, as well as \fBCPU\fR utilization. The first line of output is for all
40 time since boot; each subsequent line is for the prior interval only.
41 .sp
42 .LP
43 To compute this information, the kernel maintains a number of counters. For
44 each disk, the kernel counts reads, writes, bytes read, and bytes written. The
45 kernel also takes hi-res time stamps at queue entry and exit points, which
46 allows it to keep track of the residence time and cumulative residence-length
47 product for each queue. Using these values, \fBiostat\fR produces highly
48 accurate measures of throughput, utilization, queue lengths, transaction rates
49 and service time. For terminals collectively, the kernel simply counts the
50 number of input and output characters.
51 .sp
350
351 .sp
352 .ne 2
353 .na
354 \fB\fB-p\fR\fR
355 .ad
356 .RS 12n
357 For each disk, report per-partition statistics in addition to per-device
358 statistics.
359 .RE
360
361 .sp
362 .ne 2
363 .na
364 \fB\fB-P\fR\fR
365 .ad
366 .RS 12n
367 For each disk, report per-partition statistics only, no per-device statistics.
368 .RE
369
370 .sp
371 .ne 2
372 .na
373 \fB\fB-f\fR\fR
374 .ad
375 .RS 12n
376 Report ZFS-level statistics for ZFS pool and individual vdevs in addition to
377 per-device statistics.
378 .RE
379
380 .sp
381 .ne 2
382 .na
383 \fB\fB-F\fR\fR
384 .ad
385 .RS 12n
386 Report ZFS pool and individual physical vdevs statistics only, no per-device
387 statistics.
388 .RE
389
390 .sp
391 .ne 2
392 .na
393 \fB\fB-r\fR\fR
394 .ad
395 .RS 12n
396 Display data in a comma-separated format.
397 .RE
398
399 .sp
400 .ne 2
401 .na
402 \fB\fB-s\fR\fR
403 .ad
404 .RS 12n
405 Suppress messages related to \fBstate changes\fR.
406 .RE
407
408 .sp
409 .ne 2
|