X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;ds=sidebyside;f=fio.1;h=4377052ff61ae88224f4668304c7f8a6de4874b6;hb=e7f5de90cbc0b51d4300a9fc0d080275b2730a32;hp=82d05b77b7319cc87216b1a84a23b34f067fa618;hpb=ce35b1ece06ce27ebff111e47c2a6610c311a92b;p=fio.git diff --git a/fio.1 b/fio.1 index 82d05b77..4377052f 100644 --- a/fio.1 +++ b/fio.1 @@ -32,6 +32,9 @@ Generate per-job bandwidth logs. .B \-\-minimal Print statistics in a terse, semicolon-delimited format. .TP +.B \-\-append-terse +Print statistics in selected mode AND terse, semicolon-delimited format. +.TP .B \-\-version Display version information and exit. .TP @@ -41,6 +44,14 @@ Set terse version output format (Current version 3, or older version 2). .B \-\-help Display usage information and exit. .TP +.B \-\-cpuclock-test +Perform test and validation of internal CPU clock +.TP +.BI \-\-crctest[\fR=\fPtest] +Test the speed of the builtin checksumming functions. If no argument is given, +all of them are tested. Or a comma separated list can be passed, in which +case the given ones are tested. +.TP .BI \-\-cmdhelp \fR=\fPcommand Print help information for \fIcommand\fR. May be `all' for all commands. .TP @@ -113,12 +124,16 @@ String: a sequence of alphanumeric characters. SI integer: a whole number, possibly containing a suffix denoting the base unit 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). A suffix may include a trailing 'b', -for instance 'kb' is identical to 'k'. You can specify a base 10 value -by using 'KiB', 'MiB', 'GiB', etc. This is useful for disk drives where -values are often given in base 10 values. Specifying '30GiB' will get you -30*1000^3 bytes. +respectively. If prefixed with '0x', the value is assumed to be base 16 +(hexadecimal). A suffix may include a trailing 'b', for instance 'kb' is +identical to 'k'. You can specify a base 10 value by using 'KiB', 'MiB','GiB', +etc. This is useful for disk drives where values are often given in base 10 +values. Specifying '30GiB' will get you 30*1000^3 bytes. +When specifying times the default suffix meaning changes, still denoting the +base unit of the value, but accepted suffixes are 'D' (days), 'H' (hours), 'M' +(minutes), 'S' Seconds, 'ms' milli seconds. Time values without a unit specify +seconds. +The suffixes are not case sensitive. .TP .I bool Boolean: a true or false value. `0' denotes false, `1' denotes true. @@ -146,6 +161,12 @@ otherwise has no special purpose. .BI directory \fR=\fPstr Prefix filenames with this directory. Used to place files in a location other than `./'. +You can specify a number of directories by separating the names with a ':' +character. These directories will be assigned equally distributed to job clones +creates with \fInumjobs\fR as long as they are using generated filenames. +If specific \fIfilename(s)\fR are set fio will use the first listed directory, +and thereby matching the \fIfilename\fR semantic which generates a file each +clone if not specified, but let all clones use the same if set. .TP .BI filename \fR=\fPstr .B fio @@ -285,8 +306,12 @@ read, write, and trim are accounted and reported separately. If this option is set, the fio will sum the results and report them as "mixed" instead. .TP .BI randrepeat \fR=\fPbool -Seed the random number generator in a predictable way so results are repeatable -across runs. Default: true. +Seed the random number generator used for random I/O patterns in a predictable +way so the pattern is repeatable across runs. Default: true. +.TP +.BI allrandrepeat \fR=\fPbool +Seed all random number generators in a predictable way so results are +repeatable across runs. Default: false. .TP .BI randseed \fR=\fPint Seed the random number generators based on this seed value, to be able to @@ -549,6 +574,11 @@ transfer as fio ioengine .B e4defrag IO engine that does regular EXT4_IOC_MOVE_EXT ioctls to simulate defragment activity request to DDIR_WRITE event +.TP +.B rbd +IO engine supporting direct access to Ceph Rados Block Devices (RBD) via librbd +without the need to use the kernel rbd driver. This ioengine defines engine specific +options. .RE .P .RE @@ -825,8 +855,12 @@ needed to be specified. For \fBprefer\fR, only one node is allowed. For \fBbind\fR and \fBinterleave\fR, \fBnodelist\fR allows comma delimited list of numbers, A-B ranges, or 'all'. .TP -.BI startdelay \fR=\fPint -Delay start of job for the specified number of seconds. +.BI startdelay \fR=\fPirange +Delay start of job for the specified number of seconds. Supports all time +suffixes to allow specification of hours, minutes, seconds and +milliseconds - seconds are the default if a unit is ommited. +Can be given as a range which causes each thread to choose randomly out of the +range. .TP .BI runtime \fR=\fPint Terminate processing after the specified number of seconds. @@ -934,6 +968,13 @@ Unlink job files when done. Default: false. Specifies the number of iterations (runs of the same workload) of this job. Default: 1. .TP +.BI verify_only \fR=\fPbool +Do not perform the specified workload, only verify data still matches previous +invocation of this workload. This option allows one to check data multiple +times at a later date without overwriting it. This option makes sense only for +workloads that write data, and does not support workloads with the +\fBtime_based\fR option set. +.TP .BI do_verify \fR=\fPbool Run the verify phase after a write phase. Only valid if \fBverify\fR is set. Default: true. @@ -1333,9 +1374,15 @@ The network protocol to use. Accepted values are: .B tcp Transmission control protocol .TP +.B tcpv6 +Transmission control protocol V6 +.TP .B udp User datagram protocol .TP +.B udpv6 +User datagram protocol V6 +.TP .B unix UNIX domain socket .RE @@ -1373,6 +1420,15 @@ Preallocate donor's file on init .BI 1: allocate space immediately inside defragment event, and free right after event .RE +.TP +.BI (rbd)rbdname \fR=\fPstr +Specifies the name of the RBD. +.TP +.BI (rbd)pool \fR=\fPstr +Specifies the name of the Ceph pool containing the RBD. +.TP +.BI (rbd)clientname \fR=\fPstr +Specifies the username (without the 'client.' prefix) used to access the Ceph cluster. .SH OUTPUT While running, \fBfio\fR will display the status of the created jobs. For example: @@ -1525,9 +1581,10 @@ It is also possible to get fio to dump the current output while it is running, without terminating the job. To do that, send fio the \fBUSR1\fR signal. .SH TERSE OUTPUT -If the \fB\-\-minimal\fR option is given, the results will be printed in a -semicolon-delimited format suitable for scripted use - a job description -(if provided) follows on a new line. Note that the first +If the \fB\-\-minimal\fR / \fB\-\-append-terse\fR options are given, the +results will be printed/appended in a semicolon-delimited format suitable for +scripted use. +A job description (if provided) follows on a new line. Note that the first number in the line is the version number. If the output has to be changed for some reason, this number will be incremented by 1 to signify that change. The fields are: