IO engine How do we issue io? We could be memory mapping the
file, we could be using regular read/write, we
- could be using splice, async io, or even
+ could be using splice, async io, syslet, or even
SG (SCSI generic sg).
IO depth If the io engine is async, how large a queuing
special purpose of also signaling the start of a new
job.
+description=str Text description of the job. Doesn't do anything except
+ dump this text description when this job is run. It's
+ not parsed.
+
directory=str Prefix filenames with this directory. Used to places files
in a different location than "./".
filename=str Fio normally makes up a filename based on the job name,
thread number, and file number. If you want to share
files between threads in a job or several jobs, specify
- a filename for each of them to override the default.
+ a filename for each of them to override the default. If
+ the ioengine used is 'net', the filename is the host and
+ port to connect to in the format of =host:port.
rw=str Type of io pattern. Accepted values are:
vmsplice(2) to transfer data from user
space to the kernel.
+ syslet-rw Use the syslet system calls to make
+ regular read/write async.
+
sg SCSI generic sg v3 io. May either be
synchronous using the SG_IO ioctl, or if
the target is an sg character device
to. This is mainly used to exercise fio
itself and for debugging/testing purposes.
+ net Transfer over the network to given host:port.
+ 'filename' must be set appropriately to
+ filename=host:port regardless of send
+ or receive, if the latter only the port
+ argument is used.
+
iodepth=int This defines how many io units to keep in flight against
the file. The default is 1 for each file defined in this
job, can be overridden with a larger value for higher
create_fsync=bool fsync the data file after creation. This is the
default.
-unlink=bool Unlink the job files when done. fio defaults to doing this,
- if it created the file itself.
+unlink=bool Unlink the job files when done. Not the default, as repeated
+ runs of that job would then waste time recreating the fileset
+ again and again.
loops=int Run the specified number of iterations of this job. Used
to repeat the same workload a given number of times. Defaults