summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorkpande <[email protected]>2019-02-21 14:00:48 -0800
committerBrian Behlendorf <[email protected]>2019-02-21 14:00:48 -0800
commitf8bb2a7e0c889d6c5cf7655d698869b3a32c2bb0 (patch)
treee262994b516fcb32d69ed17acec228be34c6dcca
parentf23b0242b68723d7ca998cd6cfa5ff9e8c98c985 (diff)
Clarify zpool iostat statistics reporting
Document expected behavior for zpool iostat statistics reporting. Reviewed by: Matt Ahrens <[email protected]> Reviewed-by: Alek Pinchuk <[email protected]> Reviewed-by: Brian Behlendorf <[email protected]> Reviewed by: Allan Jude <[email protected]> Signed-off-by: Kash Pande <[email protected]> Closes #2888 Closes #8417
-rw-r--r--man/man8/zpool.813
1 files changed, 9 insertions, 4 deletions
diff --git a/man/man8/zpool.8 b/man/man8/zpool.8
index 800ada566..6dbd6c556 100644
--- a/man/man8/zpool.8
+++ b/man/man8/zpool.8
@@ -1635,10 +1635,15 @@ with no flags on the relevant target devices.
.Oo Oo Ar pool Ns ... Oc Ns | Ns Oo Ar pool vdev Ns ... Oc Ns | Ns Oo Ar vdev Ns ... Oc Oc
.Op Ar interval Op Ar count
.Xc
-Displays I/O statistics for the given pools/vdevs. You can pass in a
-list of pools, a pool and list of vdevs in that pool, or a list of any
-vdevs from any pool. If no items are specified, statistics for every
-pool in the system are shown.
+Displays logical I/O statistics for the given pools/vdevs. Physical I/Os may
+be observed via
+.Xr iostat 1 .
+If writes are located nearby, they may be merged into a single
+larger operation. Additional I/O may be generated depending on the level of
+vdev redundancy.
+To filter output, you may pass in a list of pools, a pool and list of vdevs
+in that pool, or a list of any vdevs from any pool. If no items are specified,
+statistics for every pool in the system are shown.
When given an
.Ar interval ,
the statistics are printed every