From: kpande Date: Thu, 21 Feb 2019 22:00:48 +0000 (-0800) Subject: Clarify zpool iostat statistics reporting X-Git-Tag: zfs-0.8.0-rc4~106 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=f8bb2a7e0c889d6c5cf7655d698869b3a32c2bb0;p=zfs Clarify zpool iostat statistics reporting Document expected behavior for zpool iostat statistics reporting. Reviewed by: Matt Ahrens Reviewed-by: Alek Pinchuk Reviewed-by: Brian Behlendorf Reviewed by: Allan Jude Signed-off-by: Kash Pande Closes #2888 Closes #8417 --- 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