X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;f=fio.1;h=a23258578a49cff73123a7abf41281d5118c0553;hb=cc47f094d73a6a48a5ae18f5b6fe0ae483a63a32;hp=2320ba341fc5efdf839afb350981f185a3906327;hpb=23ed19b0e10749dca2389511f78d89db886c064a;p=fio.git diff --git a/fio.1 b/fio.1 index 2320ba34..a2325857 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 @@ -128,8 +131,8 @@ 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. +(minutes), 'S' Seconds, 'ms' (or msec) milli seconds, 'us' (or 'usec') micro +seconds. Time values without a unit specify seconds. The suffixes are not case sensitive. .TP .I bool @@ -158,6 +161,14 @@ 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. See +\fIfilename\fR for considerations regarding escaping certain characters on +some platforms. .TP .BI filename \fR=\fPstr .B fio @@ -167,7 +178,12 @@ specify a \fIfilename\fR for each of them to override the default. If the I/O engine is file-based, you can specify a number of files by separating the names with a `:' character. `\-' is a reserved name, meaning stdin or stdout, depending on the read/write direction -set. +set. On Windows, disk devices are accessed as \\.\PhysicalDrive0 for the first +device, \\.\PhysicalDrive1 for the second etc. Note: Windows and FreeBSD +prevent write access to areas of the disk containing in-use data +(e.g. filesystems). If the wanted filename does need to include a colon, then +escape that with a '\' character. For instance, if the filename is +"/dev/dsk/foo@3,0:c", then you would use filename="/dev/dsk/foo@3,0\:c". .TP .BI filename_format \fR=\fPstr If sharing multiple files between jobs, it is usually necessary to have @@ -370,6 +386,12 @@ for files at random within the given range, limited to \fBsize\fR in total (if that is given). If \fBfilesize\fR is not specified, each created file is the same size. .TP +.BI file_append \fR=\fPbool +Perform IO after the end of the file. Normally fio will operate within the +size of a file. If this option is set, then fio will append to the file +instead. This has identical behavior to setting \fRoffset\fP to the size +of a file. This option is ignored on non-regular files. +.TP .BI blocksize \fR=\fPint[,int] "\fR,\fB bs" \fR=\fPint[,int] Block size for I/O units. Default: 4k. Values for reads, writes, and trims can be specified separately in the format \fIread\fR,\fIwrite\fR,\fItrim\fR @@ -414,6 +436,8 @@ blocksize setting. .TP .B zero_buffers Initialise buffers with all zeros. Default: fill buffers with random data. +The resulting IO buffers will not be completely zeroed, unless +\fPscramble_buffers\fR is also turned off. .TP .B refill_buffers If this option is given, fio will refill the IO buffers on every submit. The @@ -570,6 +594,16 @@ request to DDIR_WRITE event 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. +.TP +.B gfapi +Using Glusterfs libgfapi sync interface to direct access to Glusterfs volumes without +having to go through FUSE. This ioengine defines engine specific +options. +.TP +.B gfapi_async +Using Glusterfs libgfapi async interface to direct access to Glusterfs volumes without +having to go through FUSE. This ioengine defines engine specific +options. .RE .P .RE @@ -824,6 +858,26 @@ may run on. See \fBsched_setaffinity\fR\|(2). .BI cpus_allowed \fR=\fPstr Same as \fBcpumask\fR, but allows a comma-delimited list of CPU numbers. .TP +.BI cpus_allowed_policy \fR=\fPstr +Set the policy of how fio distributes the CPUs specified by \fBcpus_allowed\fR +or \fBcpumask\fR. Two policies are supported: +.RS +.RS +.TP +.B shared +All jobs will share the CPU set specified. +.TP +.B split +Each job will get a unique CPU from the CPU set. +.RE +.P +\fBshared\fR is the default behaviour, if the option isn't specified. If +\fBsplit\fR is specified, then fio will assign one cpu per job. If not enough +CPUs are given for the jobs listed, then fio will roundrobin the CPUs in +the set. +.RE +.P +.TP .BI numa_cpu_nodes \fR=\fPstr Set this job running on specified NUMA nodes' CPUs. The arguments allow comma delimited list of cpu numbers, A-B ranges, or 'all'. @@ -976,7 +1030,7 @@ values are: .RS .RS .TP -.B md5 crc16 crc32 crc32c crc32c-intel crc64 crc7 sha256 sha512 sha1 +.B md5 crc16 crc32 crc32c crc32c-intel crc64 crc7 sha256 sha512 sha1 xxhash Store appropriate checksum in the header of each block. crc32c-intel is hardware accelerated SSE4.2 driven, falls back to regular crc32c if not supported by the system. @@ -1572,9 +1626,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: