X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;f=fio.1;h=5d0988b2cef496bfd8cd945aba0f332f04dee9ac;hb=7758d4f0b0f87d53826e1a6a6302bdc16667ed2d;hp=4445d0a3a99989191c70e8359e8c8bc82248613e;hpb=0e92f873a3d542d2b237d68fd9391c92a85fa0b8;p=fio.git diff --git a/fio.1 b/fio.1 index 4445d0a3..5d0988b2 100644 --- a/fio.1 +++ b/fio.1 @@ -182,6 +182,11 @@ reasons. Allow values are 1024 or 1000, with 1024 being the default. Seed the random number generator in a predictable way so results are repeatable across runs. Default: true. .TP +.BI fallocate \fR=\fPbool +By default, fio will use fallocate() to advise the system of the size of the +file we are going to write. This can be turned off with fallocate=0. May not +be available on all supported platforms. +.TP .BI fadvise_hint \fR=\fPbool Disable use of \fIposix_fadvise\fR\|(2) to advise the kernel what I/O patterns are likely to be issued. Default: true. @@ -375,6 +380,27 @@ How many I/Os to perform before issuing an \fBfsync\fR\|(2) of dirty data. If Like \fBfsync\fR, but uses \fBfdatasync\fR\|(2) instead to only sync the data parts of the file. Default: 0. .TP +.BI sync_file_range \fR=\fPstr:int +Use sync_file_range() for every \fRval\fP number of write operations. Fio will +track range of writes that have happened since the last sync_file_range() call. +\fRstr\fP can currently be one or more of: +.RS +.TP +.B wait_before +SYNC_FILE_RANGE_WAIT_BEFORE +.TP +.B write +SYNC_FILE_RANGE_WRITE +.TP +.B wait_after +SYNC_FILE_RANGE_WRITE +.TP +.RE +.P +So if you do sync_file_range=wait_before,write:8, fio would use +\fBSYNC_FILE_RANGE_WAIT_BEFORE | SYNC_FILE_RANGE_WRITE\fP for every 8 writes. +Also see the sync_file_range(2) man page. This option is Linux specific. +.TP .BI overwrite \fR=\fPbool If writing, setup the file first and do overwrites. Default: false. .TP @@ -725,13 +751,23 @@ entering the kernel with a gettimeofday() call. The CPU set aside for doing these time calls will be excluded from other uses. Fio will manually clear it from the CPU mask of other jobs. .TP -.BI continue_on_error \fR=\fPbool -Normally fio will exit the job on the first observed failure. If this option is -set, fio will continue the job when there is a 'non-fatal error' -(\fBEIO\fR or \fBEILSEQ\fR) until the runtime is exceeded or the I/O size -specified is completed. If this option is used, there are two more stats that -are appended, the total error count and the first error. The error field given -in the stats is the first error that was hit during the run. +.BI cgroup \fR=\fPstr +Add job to this control group. If it doesn't exist, it will be created. +The system must have a mounted cgroup blkio mount point for this to work. If +your system doesn't have it mounted, you can do so with: + +# mount -t cgroup -o blkio none /cgroup +.TP +.BI cgroup_weight \fR=\fPint +Set the weight of the cgroup to this value. See the documentation that comes +with the kernel, allowed values are in the range of 100..1000. +.TP +.BI uid \fR=\fPint +Instead of running as the invoking user, set the user ID to this value before +the thread/process does any work. +.TP +.BI gid \fR=\fPint +Set group ID, see \fBuid\fR. .SH OUTPUT While running, \fBfio\fR will display the status of the created jobs. For example: