HOWTO/manpage: update percentage explanation using '%'
authorTomohiro Kusumi <>
Wed, 28 Jun 2017 14:21:05 +0000 (17:21 +0300)
committerJens Axboe <>
Wed, 28 Jun 2017 14:30:50 +0000 (08:30 -0600)
82dbb8cb (HOWTO: add offset unit info for offset= option) added
how to specify offset= option in percentage format based on below post,
which was technically correct, but str_to_decimal() invoked via
option parser can convert '%' format to low-level representation.

This commit replaces 82dbb8cb using '%' syntax since this is
considered better for documentation. Note that size= option which
also supports percentage uses '%' in documentation.

in what units is offset option?

Signed-off-by: Tomohiro Kusumi <>
Signed-off-by: Jens Axboe <>

diff --git a/HOWTO b/HOWTO
index 37caa3c0ecd54a9371f483755ccb1f58dfdaf152..a07c5f2b1a7fd19f98edc1be42d5aa99dbc1b2bc 100644 (file)
--- a/HOWTO
+++ b/HOWTO
@@ -1095,8 +1095,8 @@ I/O type
        offset will be used. Data before the given offset will not be touched. This
        effectively caps the file size at `real_size - offset`. Can be combined with
        :option:`size` to constrain the start and end range of the I/O workload.
-       A percentage can be specified by the percentage number plus 1 with preceding '-'.
-       For example, -1 is parsed as 0%, -10 is parsed as 9%, -101 is parsed as 100%.
+       A percentage can be specified by a number between 1 and 100 followed by '%',
+       for example, ``offset=20%`` to specify 20%.
 .. option:: offset_increment=int
diff --git a/fio.1 b/fio.1
index ac87c9ddd6efe316e98d584a8e9346b7104f6916..ca99ad743f65d7333faef5caa21f30c4e286bdf1 100644 (file)
--- a/fio.1
+++ b/fio.1
@@ -1,4 +1,4 @@
-.TH fio 1 "May 2017" "User Manual"
+.TH fio 1 "June 2017" "User Manual"
 fio \- flexible I/O tester
@@ -916,8 +916,8 @@ bytes or a percentage. If a percentage is given, the next \fBblockalign\fR-ed
 offset will be used. Data before the given offset will not be touched. This
 effectively caps the file size at (real_size - offset). Can be combined with
 \fBsize\fR to constrain the start and end range of the I/O workload. A percentage
-can be specified by the percentage number plus 1 with preceding '-'. For example,
--1 is parsed as 0%, -10 is parsed as 9%, -101 is parsed as 100%.
+can be specified by a number between 1 and 100 followed by '%', for example,
+offset=20% to specify 20%.
 .BI offset_increment \fR=\fPint
 If this is provided, then the real offset becomes the