From: Tomohiro Kusumi Date: Wed, 28 Jun 2017 14:21:05 +0000 (+0300) Subject: HOWTO/manpage: update percentage explanation using '%' X-Git-Tag: fio-2.99~18 X-Git-Url: https://git.kernel.dk/?p=fio.git;a=commitdiff_plain;h=44bb11426e9fe13c509594bc205e4b61225e7483 HOWTO/manpage: update percentage explanation using '%' 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? http://www.spinics.net/lists/fio/msg05969.html Signed-off-by: Tomohiro Kusumi Signed-off-by: Jens Axboe --- diff --git a/HOWTO b/HOWTO index 37caa3c0..a07c5f2b 100644 --- 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 ac87c9dd..ca99ad74 100644 --- a/fio.1 +++ b/fio.1 @@ -1,4 +1,4 @@ -.TH fio 1 "May 2017" "User Manual" +.TH fio 1 "June 2017" "User Manual" .SH NAME fio \- flexible I/O tester .SH SYNOPSIS @@ -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%. .TP .BI offset_increment \fR=\fPint If this is provided, then the real offset becomes the