X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;f=HOWTO;h=76613714a14a063b4adc3133ee954f2b966748aa;hb=2b4ce34fac9f3031dc8606d6cd640c61a74d7df7;hp=c14039318175c6170dbec9c3c7be55d80ff16801;hpb=4e991c23d2d06484f581eb5e2105bc102cb35941;p=fio.git diff --git a/HOWTO b/HOWTO index c1403931..76613714 100644 --- a/HOWTO +++ b/HOWTO @@ -216,6 +216,7 @@ filename=str Fio normally makes up a filename based on the job name, opendir=str Tell fio to recursively add any file it can find in this directory and down the file system tree. +readwrite=str rw=str Type of io pattern. Accepted values are: read Sequential reads @@ -244,6 +245,7 @@ filesize=siint Individual file sizes. May be a range, in which case fio and limited to 'size' in total (if that is given). If not given, each created file is the same size. +blocksize=siint bs=siint The block size used for the io units. Defaults to 4k. Values can be given for both read and writes. If a single siint is given, it will apply to both. If a second siint is specified @@ -254,6 +256,7 @@ bs=siint The block size used for the io units. Defaults to 4k. Values can do so by passing an empty read size - bs=,8k will set 8k for writes and leave the read default value. +blocksize_range=irange bsrange=irange Instead of giving a single block size, specify a range and fio will mix the issued io block sizes. The issued io unit will always be a multiple of the minimum value @@ -261,6 +264,7 @@ bsrange=irange Instead of giving a single block size, specify a range writes, however a second range can be given after a comma. See bs=. +blocksize_unaligned bs_unaligned If this option is given, any byte size value within bsrange may be used as a block range. This typically wont work with direct IO, as that normally requires sector alignment. @@ -326,6 +330,14 @@ ioengine=str Defines how the job issues io to the file. The following will cause that job to do nothing but burn 85% of the CPU. + guasi The GUASI IO engine is the Generic Userspace + Asyncronous Syscall Interface approach + to async IO. See + + http://www.xmailserver.org/guasi-lib.html + + for more info on GUASI. + external Prefix to specify loading an external IO engine object file. Append the engine filename, eg ioengine=external:/tmp/foo.o @@ -452,6 +464,7 @@ invalidate=bool Invalidate the buffer/page cache parts for this file prior sync=bool Use sync io for buffered writes. For the majority of the io engines, this means using O_SYNC. +iomem=str mem=str Fio can use various types of memory as the io unit buffer. The allowed values are: @@ -534,7 +547,13 @@ verify=str If writing to a file, fio can verify the file contents stonewall Wait for preceeding jobs in the job file to exit, before starting this one. Can be used to insert serialization - points in the job file. + points in the job file. A stone wall also implies starting + a new reporting group. + +new_group Start a new reporting group. If this option isn't given, + jobs in a file will be part of the same reporting group + unless seperated by a stone wall (or if it's a group + by itself, with the numjobs option). numjobs=int Create the specified number of clones of this job. May be used to setup a larger number of threads/processes doing @@ -647,7 +666,7 @@ they denote: io= Number of megabytes io performed bw= Average bandwidth rate runt= The runtime of that thread - slat= Submission latency (avg being the average, dev being the + slat= Submission latency (avg being the average, stdev being the standard deviation). This is the time it took to submit the io. For sync io, the slat is really the completion latency, since queue/complete is one operation there.