X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=fio.1;h=b3925b5f19b766b3cdba94ceca463e01adcde58b;hp=32993b61da4bccc9ba633da361bc1e47a68aaa08;hb=b09da8fa5be85634a3e8331d6e5ce07cd427a5a2;hpb=9c0d224129b0c59698e4c77e7fed00dc8cbb50e1 diff --git a/fio.1 b/fio.1 index 32993b61..b3925b5f 100644 --- a/fio.1 +++ b/fio.1 @@ -78,9 +78,10 @@ String: a sequence of alphanumeric characters. .TP .I int SI integer: a whole number, possibly containing a suffix denoting the base unit -of the value. Accepted suffixes are `k', 'M' and 'G', denoting kilo (1024), -mega (1024*1024) and giga (1024*1024*1024) respectively. If prefixed with '0x', -the value is assumed to be base 16 (hexadecimal). +of the value. Accepted suffixes are `k', 'M', 'G', 'T', and 'P', denoting +kilo (1024), mega (1024^2), giga (1024^3), tera (1024^4), and peta (1024^5) +respectively. The suffix is not case sensitive. If prefixed with '0x', the +value is assumed to be base 16 (hexadecimal). .TP .I bool Boolean: a true or false value. `0' denotes false, `1' denotes true. @@ -172,6 +173,11 @@ to perform before getting a new offset can be specified by appending `:\fIint\fR' to the pattern type. The default is 1. .RE .TP +.BI kb_base \fR=\fPint +The base unit for a kilobyte. The defacto base is 2^10, 1024. Storage +manufacturers like to use 10^3 or 1000 as a base ten unit instead, for obvious +reasons. Allow values are 1024 or 1000, with 1024 being the default. +.TP .BI randrepeat \fR=\fPbool Seed the random number generator in a predictable way so results are repeatable across runs. Default: true. @@ -523,7 +529,7 @@ sum of the \fBiomem_align\fR and \fBbs\fR used. .TP .BI hugepage\-size \fR=\fPint Defines the size of a huge page. Must be at least equal to the system setting. -Should be a multiple of 1MiB. Default: 4MiB. +Should be a multiple of 1MB. Default: 4MB. .TP .B exitall Terminate all jobs when one finishes. Default: wait for each job to finish. @@ -598,6 +604,18 @@ Write the verification header for this number of bytes, which should divide If true, exit the job on the first observed verification failure. Default: false. .TP +.BI verify_async \fR=\fPint +Fio will normally verify IO inline from the submitting thread. This option +takes an integer describing how many async offload threads to create for IO +verification instead, causing fio to offload the duty of verifying IO contents +to one or more separate threads. If using this offload option, even sync IO +engines can benefit from using an \fBiodepth\fR setting higher than 1, as it +allows them to have IO in flight while verifies are running. +.TP +.BI verify_async_cpus \fR=\fPstr +Tell fio to set the given CPU affinity on the async IO verification threads. +See \fBcpus_allowed\fP for the format used. +.TP .B stonewall Wait for preceeding jobs in the job file to exit before starting this one. \fBstonewall\fR implies \fBnew_group\fR. @@ -859,7 +877,7 @@ semicolon-delimited format suitable for scripted use. The fields are: .P Read status: .RS -.B KiB I/O, bandwidth \fR(KiB/s)\fP, runtime \fR(ms)\fP +.B KB I/O, bandwidth \fR(KB/s)\fP, runtime \fR(ms)\fP .P Submission latency: .RS @@ -877,7 +895,7 @@ Bandwidth: .P Write status: .RS -.B KiB I/O, bandwidth \fR(KiB/s)\fP, runtime \fR(ms)\fP +.B KB I/O, bandwidth \fR(KB/s)\fP, runtime \fR(ms)\fP .P Submission latency: .RS