From: Jens Axboe Date: Wed, 5 Sep 2018 15:29:00 +0000 (-0600) Subject: Document oddity with --status-interval and --output-format=json X-Git-Tag: fio-3.9~5 X-Git-Url: https://git.kernel.dk/?p=fio.git;a=commitdiff_plain;h=c1f4de8ab8a558a1b302091e97259875f2595b48 Document oddity with --status-interval and --output-format=json Signed-off-by: Jens Axboe --- diff --git a/HOWTO b/HOWTO index 7bbd5898..0c5b7109 100644 --- a/HOWTO +++ b/HOWTO @@ -194,7 +194,10 @@ Command line options Force a full status dump of cumulative (from job start) values at `time` intervals. This option does *not* provide per-period measurements. So values such as bandwidth are running averages. When the time unit is omitted, - `time` is interpreted in seconds. + `time` is interpreted in seconds. Note that using this option with + ``--output-format=json`` will yield output that technically isn't valid + json, since the output will be collated sets of valid json. It will need + to be split into valid sets of json after the run. .. option:: --section=name diff --git a/fio.1 b/fio.1 index b555b208..593f4db1 100644 --- a/fio.1 +++ b/fio.1 @@ -93,7 +93,10 @@ the value is interpreted in seconds. Force a full status dump of cumulative (from job start) values at \fItime\fR intervals. This option does *not* provide per-period measurements. So values such as bandwidth are running averages. When the time unit is omitted, -\fItime\fR is interpreted in seconds. +\fItime\fR is interpreted in seconds. Note that using this option with +`\-\-output-format=json' will yield output that technically isn't valid json, +since the output will be collated sets of valid json. It will need to be split +into valid sets of json after the run. .TP .BI \-\-section \fR=\fPname Only run specified section \fIname\fR in job file. Multiple sections can be specified.