From be3fec7d9305c62a7cd2354b535e9a6b89a58a94 Mon Sep 17 00:00:00 2001 From: Jens Axboe Date: Sun, 28 Sep 2014 16:24:23 -0600 Subject: [PATCH] Clarify what number_ios does in the HOWTO/man page/help Signed-off-by: Jens Axboe --- HOWTO | 4 +++- fio.1 | 4 +++- options.c | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/HOWTO b/HOWTO index aaa46f80..e770b99d 100644 --- 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 bc6c9fa6..d64fbb7a 100644 --- 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 56e9108a..3a7c41a9 100644 --- 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, -- 2.25.1