X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=README;h=bc2574e7f781b11815fde6eba24732c5610a0e70;hp=9121d4cf914795b8cb9d745b58066a62a7788681;hb=fc1a471326fb5248a74ed3a206d37884b812c853;hpb=20dc95c47087d486b5d4608fc15b1c2021761923 diff --git a/README b/README index 9121d4cf..bc2574e7 100644 --- a/README +++ b/README @@ -33,19 +33,21 @@ $ fio -l Generate per-job latency logs -w Generate per-job bandwidth logs -f Read for job descriptions + -h Print help info -v Print version information and exit The format is as follows: directory=x Use 'x' as the top level directory for storing files - rw=x 'x' may be: read, randread, write, or randwrite + rw=x 'x' may be: read, randread, write, randwrite, + rw (read-write mix), randrw (read-write random mix) size=x Set file size to x bytes (x string can include k/m/g) ioengine=x 'x' may be: aio/libaio/linuxaio for Linux aio, posixaio for POSIX aio, sync for regular read/write io, - mmap for mmap'ed io, or sgio for direct SG_IO io. The - latter only works on Linux on SCSI (or SCSI-like - devices, such as usb-storage or sata/libata driven) - devices. + mmap for mmap'ed io, splice for using splice/vmsplice, + or sgio for direct SG_IO io. The latter only works on + Linux on SCSI (or SCSI-like devices, such as + usb-storage or sata/libata driven) devices. iodepth=x For async io, allow 'x' ios in flight overwrite=x If 'x', layout a write file first. prio=x Run io at prio X, 0-7 is the kernel allowed range @@ -71,6 +73,7 @@ The format is as follows: bwavgtime=x Average bandwidth stats over an x msec window. create_serialize=x If 'x', serialize file creation. create_fsync=x If 'x', run fsync() after file creation. + end_fsync=x If 'x', run fsync() after end-of-job. loops=x Run the job 'x' number of times. verify=x If 'x' == md5, use md5 for verifies. If 'x' == crc32, use crc32 for verifies. md5 is 'safer', but crc32 is @@ -84,6 +87,11 @@ The format is as follows: can be used to gauge hard drive speed over the entire platter, without reading everything. Both x/y can include k/m/g suffix. + iolog=x Open and read io pattern from file 'x'. The file must + contain one io action per line in the following format: + rw, offset, length + where with rw=0/1 for read/write, and the offset + and length entries being in bytes. Examples using a job file