From 2a92925771284c222229bd0fb2576b8972f3f6bc Mon Sep 17 00:00:00 2001 From: Nikolaus Rath Date: Tue, 20 Apr 2021 12:07:46 +0100 Subject: [PATCH] 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 --- HOWTO | 11 ++++++----- fio.1 | 8 ++++---- 2 files changed, 10 insertions(+), 9 deletions(-) diff --git a/HOWTO b/HOWTO index e6078c5f..943e99d2 100644 --- 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 18dc156a..95456a32 100644 --- 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 -- 2.25.1