I/O size: fix description of filesize

Update description of `size` option to match implementation: Setting `size` does not
actually limit the total size of files created if `filesize` is specified.

Fixes: #1218

Signed-Off-By: Nikolaus Rath <Nikolaus@rath.org>

diff --git a/HOWTO b/HOWTO
index e6078c5f1e16e1143d4057b9a1e03bad21954d1f..943e99d2a5017e8d583f5b22758148297f5b3f04 100644 (file)
--- a/HOWTO
+++ b/HOWTO
@@ -1836,11 +1836,12 @@ I/O size
 
 .. option:: filesize=irange(int)
 
-       Individual file sizes. May be a range, in which case fio will select sizes
-       for files at random within the given range and limited to :option:`size` in
-       total (if that is given). If not given, each created file is the same size.
-       This option overrides :option:`size` in terms of file size, which means
-       this value is used as a fixed size or possible range of each file.
+       Individual file sizes. May be a range, in which case fio will select sizes for
+       files at random within the given range. If not given, each created file is the
+       same size. This option overrides :option:`size` in terms of file size, i.e. if
+       :option:`filesize` is specified then :option:`size` becomes merely the default
+       for :option:`io_size` and has no effect at all if :option:`io_size` is set
+       explicitly.
 
 .. option:: file_append=bool
 

diff --git a/fio.1 b/fio.1
index 18dc156ad027471b8d11083158c21688c610d93d..95456a32581438ab9293ac15c8cfe54485380673 100644 (file)
--- a/fio.1
+++ b/fio.1
@@ -1625,10 +1625,10 @@ In this case \fBio_size\fR multiplies \fBsize\fR= value.
 .TP
 .BI filesize \fR=\fPirange(int)
 Individual file sizes. May be a range, in which case fio will select sizes
-for files at random within the given range and limited to \fBsize\fR in
-total (if that is given). If not given, each created file is the same size.
-This option overrides \fBsize\fR in terms of file size, which means
-this value is used as a fixed size or possible range of each file.
+for files at random within the given range. If not given, each created file
+is the same size. This option overrides \fBsize\fR in terms of file size, 
+i.e. \fBsize\fR becomes merely the default for \fBio_size\fR (and
+has no effect it all if \fBio_size\fR is set explicitly).
 .TP
 .BI file_append \fR=\fPbool
 Perform I/O after the end of the file. Normally fio will operate within the