This commit mainly backports some minor fixups from the man page
sections covered in the several previous commits.
Signed-off-by: Tomohiro Kusumi <tkusumi@tuxera.com>
Signed-off-by: Jens Axboe <axboe@kernel.dk>
Write output to file `filename`.
Write output to file `filename`.
+.. option:: --output-format=type
+
+ Set the reporting format to `normal`, `terse`, `json`, or `json+`. Multiple
+ formats can be selected, separated by a comma. `terse` is a CSV based
+ format. `json+` is like `json`, except it adds a full dump of the latency
+ buckets.
+
+.. option:: --runtime
+ Limit run time to runtime seconds.
+
.. option:: --bandwidth-log
Generate aggregate bandwidth logs.
.. option:: --bandwidth-log
Generate aggregate bandwidth logs.
.. option:: --append-terse
Print statistics in selected mode AND terse, semicolon-delimited format.
.. option:: --append-terse
Print statistics in selected mode AND terse, semicolon-delimited format.
- **deprecated**, use :option:`--output-format` instead to select multiple
+ **Deprecated**, use :option:`--output-format` instead to select multiple
-.. option:: --output-format=type
-
- Set the reporting format to `normal`, `terse`, `json`, or `json+`. Multiple
- formats can be selected, separated by a comma. `terse` is a CSV based
- format. `json+` is like `json`, except it adds a full dump of the latency
- buckets.
-
.. option:: --terse-version=type
Set terse version output format (default 3, or 2 or 4 or 5).
.. option:: --version
.. option:: --terse-version=type
Set terse version output format (default 3, or 2 or 4 or 5).
.. option:: --version
- Print version info and exit.
+ Print version information and exit.
.. option:: --crctest=[test]
Test the speed of the built-in checksumming functions. If no argument is
.. option:: --crctest=[test]
Test the speed of the built-in checksumming functions. If no argument is
- given all of them are tested. Alternatively, a comma separated list can be passed, in
+ given, all of them are tested. Alternatively, a comma separated list can be passed, in
which case the given ones are tested.
.. option:: --cmdhelp=command
which case the given ones are tested.
.. option:: --cmdhelp=command
.. option:: --showcmd=jobfile
.. option:: --showcmd=jobfile
- Turn a job file into command line options.
+ Convert `jobfile` to a set of command-line options.
- When real-time ETA estimate should be printed. May be `always`, `never` or
- `auto`.
+ Specifies when real-time ETA estimate should be printed. `when` may be
+ `always`, `never` or `auto`.
.. option:: --eta-newline=time
.. option:: --eta-newline=time
.. option:: --section=name
.. option:: --section=name
- Only run specified section in job file. Multiple sections can be specified.
+ Only run specified section `name` in job file. Multiple sections can be specified.
The ``--section`` option allows one to combine related jobs into one file.
E.g. one job file could define light, moderate, and heavy sections. Tell
fio to run only the "heavy" section by giving ``--section=heavy``
The ``--section`` option allows one to combine related jobs into one file.
E.g. one job file could define light, moderate, and heavy sections. Tell
fio to run only the "heavy" section by giving ``--section=heavy``
.. option:: --alloc-size=kb
.. option:: --alloc-size=kb
- Set the internal smalloc pool to this size in KiB. The
+ Set the internal smalloc pool size to `kb` in KiB. The
``--alloc-size`` switch allows one to use a larger pool size for smalloc.
If running large jobs with randommap enabled, fio can run out of memory.
Smalloc is an internal allocator for shared structures from a fixed size
``--alloc-size`` switch allows one to use a larger pool size for smalloc.
If running large jobs with randommap enabled, fio can run out of memory.
Smalloc is an internal allocator for shared structures from a fixed size
.. option:: --max-jobs=nr
.. option:: --max-jobs=nr
- Maximum number of threads/processes to support.
+ Set the maximum number of threads/processes to support.
.. option:: --server=args
.. option:: --server=args
.. option:: --idle-prof=option
.. option:: --idle-prof=option
- Report CPU idleness. *option* is one of the following:
+ Report CPU idleness. `option` is one of the following:
**calibrate**
Run unit work calibration only and exit.
**calibrate**
Run unit work calibration only and exit.
compatibility with old scripts. For example, 4k means 4096.
For quantities of data, an optional unit of 'B' may be included
compatibility with old scripts. For example, 4k means 4096.
For quantities of data, an optional unit of 'B' may be included
- (e.g., 'kB' is the same as 'k').
+ (e.g., 'kB' is the same as 'k').
The *integer suffix* is not case sensitive (e.g., m/mi mean mebi/mega,
not milli). 'b' and 'B' both mean byte, not bit.
The *integer suffix* is not case sensitive (e.g., m/mi mean mebi/mega,
not milli). 'b' and 'B' both mean byte, not bit.
maximum values in that window instead of averages. Since 'data direction' and
'offset' are per-I/O values, they aren't applicable if windowed logging is enabled.
maximum values in that window instead of averages. Since 'data direction' and
'offset' are per-I/O values, they aren't applicable if windowed logging is enabled.
-------------
Normally fio is invoked as a stand-alone application on the machine where the
-------------
Normally fio is invoked as a stand-alone application on the machine where the