From: Sebastien GODARD <sysstat@users.noreply.github.com>
Date: Sat, 21 Dec 2019 17:21:09 +0000 (+0100)
Subject: Merge branch 'koct9i-flush'
X-Git-Tag: v12.3.1~7
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=cc78cca543eb61ab8648881967e5adcc5157e43e;p=sysstat

Merge branch 'koct9i-flush'

Signed-off-by: Sebastien GODARD <sysstat@users.noreply.github.com>
---

cc78cca543eb61ab8648881967e5adcc5157e43e
diff --cc man/iostat.in
index 8e991a6,437161a..d83e8ce
--- a/man/iostat.in
+++ b/man/iostat.in
@@@ -1,4 -1,4 +1,4 @@@
--.TH IOSTAT 1 "NOVEMBER 2018" Linux "Linux User's Manual" -*- nroff -*-
++.TH IOSTAT 1 "DECEMBER 2019" Linux "Linux User's Manual" -*- nroff -*-
  .SH NAME
  iostat \- Report Central Processing Unit (CPU) statistics and input/output
  statistics for devices and partitions.
@@@ -216,6 -216,12 +216,12 @@@ The number (after merges) of write requ
  .RS
  The number (after merges) of discard requests completed per second for the device.
  
+ .RE
+ .B f/s
+ .RS
+ The number (after merges) of flush requests completed per second for the device.
 -Origin (unmerged) flush operations are counted as writes (likely with zero size).
++This counts flush requests executed by disks. Flush requests are not tracked for partitions.
+ 
  .RE
  .B sec/s (kB/s, MB/s)
  .RS
@@@ -326,6 -332,13 +332,15 @@@ The average time (in milliseconds) for 
  to be served. This includes the time spent by the requests in queue and
  the time spent servicing them.
  
+ .RE
+ .B f_await
+ .RS
+ The average time (in milliseconds) for flush requests issued to the device
 -to be served. Flush requests are issued one at a time, thus flush operation
 -could be twice longer: wait current flush request, then issue and wait next.
++to be served.
++The block layer combines flush requests and executes at most one at a time.
++Thus flush operations could be twice as long: Wait for current flush request,
++then execute it, then wait for the next one.
+ 
  .RE
  .B aqu-sz
  .RS