Clarify what number_ios does in the HOWTO/man page/help

Signed-off-by: Jens Axboe <axboe@fb.com>

diff --git a/HOWTO b/HOWTO
index aaa46f801bd22d5ba113dc8726bafaf41d13858c..e770b99de49879ce74afcdec7d6c84a553c25518 100644 (file)
--- a/HOWTO
+++ b/HOWTO
@@ -823,7 +823,9 @@ number_ios=int      Fio will normally perform IOs until it has exhausted the size
                time (or hits an error condition). With this setting, the
                range/size can be set independently of the number of IOs to
                perform. When fio reaches this number, it will exit normally
-               and report status.
+               and report status. Note that this does not extend the amount
+               of IO that will be done, it will only stop fio if this
+               condition is met before other end-of-job criteria.
 
 fsync=int      If writing to a file, issue a sync of the dirty data
                for every number of blocks given. For example, if you give

diff --git a/fio.1 b/fio.1
index bc6c9fa655e8eefe13d410013309679dcf2eb7e5..d64fbb7ab5e0832f61f167d7fe2b20872f9ec2c1 100644 (file)
--- a/fio.1
+++ b/fio.1
@@ -687,7 +687,9 @@ Fio will normally perform IOs until it has exhausted the size of the region
 set by \fBsize\fR, or if it exhaust the allocated time (or hits an error
 condition). With this setting, the range/size can be set independently of
 the number of IOs to perform. When fio reaches this number, it will exit
-normally and report status.
+normally and report status. Note that this does not extend the amount
+of IO that will be done, it will only stop fio if this condition is met
+before other end-of-job criteria.
 .TP
 .BI fsync \fR=\fPint
 How many I/Os to perform before issuing an \fBfsync\fR\|(2) of dirty data.  If

diff --git a/options.c b/options.c
index 56e9108a8c35901aeffa67265555682791c2777c..3a7c41a97ac6ad2bc985144038594c3bd1afbd0d 100644 (file)
--- a/options.c
+++ b/options.c
@@ -1726,7 +1726,7 @@ struct fio_option fio_options[FIO_MAX_OPTS] = {
                .lname  = "Number of IOs to perform",
                .type   = FIO_OPT_STR_VAL,
                .off1   = td_var_offset(number_ios),
-               .help   = "Force job completion of this number of IOs",
+               .help   = "Force job completion after this number of IOs",
                .def    = "0",
                .category = FIO_OPT_C_IO,
                .group  = FIO_OPT_G_INVALID,