X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;f=HOWTO;h=494b3e64d722597405e6a82191f776c1b8bc35d7;hb=590aebda258e146edd73382121be9c84643d8f1b;hp=f4f596a4c02e7880a0394f809a1f24aae05a6737;hpb=fc6bd43c62196441607e6c36ec66bd0e16f9e4ef;p=fio.git diff --git a/HOWTO b/HOWTO index f4f596a4..494b3e64 100644 --- a/HOWTO +++ b/HOWTO @@ -230,7 +230,7 @@ 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 +directory=str Prefix filenames with this directory. Used to place files in a different location than "./". filename=str Fio normally makes up a filename based on the job name, @@ -250,7 +250,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. -lockfile=str Fio defaults to not doing any locking files before it does +lockfile=str Fio defaults to not locking any files before it does IO to them. If a file or file descriptor is shared, fio can serialize IO to that file to make the end result consistent. This is usual for emulating real workloads that @@ -303,7 +303,7 @@ fadvise_hint=bool By default, fio will use fadvise() to advise the kernel size=int The total size of file io for this job. Fio will run until this many bytes has been transferred, unless runtime is limited by other options (such as 'runtime', for instance). - Unless specific nr_files and filesize options are given, + Unless specific nrfiles and filesize options are given, fio will divide this size between the available files specified by the job. @@ -713,6 +713,11 @@ create_fsync=bool fsync the data file after creation. This is the create_on_open=bool Don't pre-setup the files for IO, just create open() when it's time to do IO to that file. +pre_read=bool If this is given, files will be pre-read into memory before + starting the given IO operation. This will also clear + the 'invalidate' flag, since it is pointless to pre-read + and then drop the cache. + unlink=bool Unlink the job files when done. Not the default, as repeated runs of that job would then waste time recreating the file set again and again. @@ -874,7 +879,7 @@ cpuload=int If the job is a CPU cycle eater, attempt to use the specified percentage of CPU cycles. cpuchunks=int If the job is a CPU cycle eater, split the load into - cycles of the given time. In milliseconds. + cycles of the given time. In microseconds. disk_util=bool Generate disk utilization statistics, if the platform supports it. Defaults to on. @@ -928,6 +933,7 @@ Idle Run P Thread setup, but not started. C Thread created. I Thread initialized, waiting. + p Thread running pre-reading file(s). R Running, doing sequential reads. r Running, doing random reads. W Running, doing sequential writes.