From: Sebastien GODARD <sysstat@users.noreply.github.com>
Date: Mon, 26 Nov 2018 08:37:56 +0000 (+0100)
Subject: iostat: Update manual page
X-Git-Tag: v12.1.2~18
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=57ec25321bb2e1d3f4feaa40f9d402d2e6d1050d;p=sysstat

iostat: Update manual page

Explain new discard I/O metrics.

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

diff --git a/man/iostat.in b/man/iostat.in
index 29bf8b9..8e991a6 100644
--- a/man/iostat.in
+++ b/man/iostat.in
@@ -180,6 +180,12 @@ and therefore have a size of 512 bytes.
 Indicate the amount of data written to the device expressed in a number of
 blocks (kilobytes, megabytes) per second.
 
+.RE
+.B Blk_dscd/s (kB_dscd/s, MB_dscd/s)
+.RS
+Indicate the amount of data discarded for the device expressed in a number of
+blocks (kilobytes, megabytes) per second.
+
 .RE
 .B Blk_read (kB_read, MB_read)
 .RS
@@ -190,6 +196,11 @@ The total number of blocks (kilobytes, megabytes) read.
 .RS
 The total number of blocks (kilobytes, megabytes) written.
 
+.RE
+.B Blk_dscd (kB_dscd, MB_dscd)
+.RS
+The total number of blocks (kilobytes, megabytes) discarded.
+
 .RE
 .B r/s
 .RS
@@ -200,11 +211,16 @@ The number (after merges) of read requests completed per second for the device.
 .RS
 The number (after merges) of write requests completed per second for the device.
 
+.RE
+.B d/s
+.RS
+The number (after merges) of discard requests completed per second for the device.
+
 .RE
 .B sec/s (kB/s, MB/s)
 .RS
-The number of sectors (kilobytes, megabytes) read from or written to the device
-per second.
+The number of sectors (kilobytes, megabytes) read from, written to or
+discarded for the device per second.
 
 .RE
 .B rsec/s (rkB/s, rMB/s)
@@ -216,6 +232,11 @@ The number of sectors (kilobytes, megabytes) read from the device per second.
 .RS
 The number of sectors (kilobytes, megabytes) written to the device per second.
 
+.RE
+.B dsec/s (dkB/s, dMB/s)
+.RS
+The number of sectors (kilobytes, megabytes) discarded for the device per second.
+
 .RE
 .B rqm/s
 .RS
@@ -231,6 +252,11 @@ The number of read requests merged per second that were queued to the device.
 .RS
 The number of write requests merged per second that were queued to the device.
 
+.RE
+.B drqm/s
+.RS
+The number of discard requests merged per second that were queued to the device.
+
 .RE
 .B %rrqm
 .RS
@@ -241,6 +267,11 @@ The percentage of read requests merged together before being sent to the device.
 .RS
 The percentage of write requests merged together before being sent to the device.
 
+.RE
+.B %drqm
+.RS
+The percentage of discard requests merged together before being sent to the device.
+
 .RE
 .B areq-sz
 .RS
@@ -261,6 +292,12 @@ device.
 The average size (in kilobytes) of the write requests that were issued to the
 device.
 
+.RE
+.B dareq-sz
+.RS
+The average size (in kilobytes) of the discard requests that were issued to the
+device.
+
 .RE
 .B await
 .RS
@@ -282,6 +319,13 @@ The average time (in milliseconds) for write requests issued to the device
 to be served. This includes the time spent by the requests in queue and
 the time spent servicing them.
 
+.RE
+.B d_await
+.RS
+The average time (in milliseconds) for discard requests issued to the device
+to be served. This includes the time spent by the requests in queue and
+the time spent servicing them.
+
 .RE
 .B aqu-sz
 .RS