X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;f=fio.1;h=305c18493843bcb5b5d136851232fd4931407d16;hb=045396879167669c3809474422bc20866c81f6d0;hp=dfca43efd9ca0707c563a5395aa31e8bde39399f;hpb=e0b0d89201bd301f47fbbfcf86545b7e77b16ef3;p=fio.git diff --git a/fio.1 b/fio.1 index dfca43ef..305c1849 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. @@ -206,14 +211,14 @@ same size. .TP .BI blocksize \fR=\fPint[,int] "\fR,\fB bs" \fR=\fPint[,int] Block size for I/O units. Default: 4k. Values for reads and writes can be -specified seperately in the format \fIread\fR,\fIwrite\fR, either of +specified separately in the format \fIread\fR,\fIwrite\fR, either of which may be empty to leave that value at its default. .TP .BI blocksize_range \fR=\fPirange[,irange] "\fR,\fB bsrange" \fR=\fPirange[,irange] Specify a range of I/O block sizes. The issued I/O unit will always be a multiple of the minimum size, unless \fBblocksize_unaligned\fR is set. Applies to both reads and writes if only one range is given, but can be specified -seperately with a comma seperating the values. Example: bsrange=1k-4k,2k-8k. +separately with a comma seperating the values. Example: bsrange=1k-4k,2k-8k. Also (see \fBblocksize\fR). .TP .BI bssplit \fR=\fPstr @@ -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 @@ -736,6 +762,12 @@ your system doesn't have it mounted, you can do so with: 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 cgroup_nodelete \fR=\fPbool +Normally fio will delete the cgroups it has created after the job completion. +To override this behavior and to leave cgroups around after the job completion, +set cgroup_nodelete=1. This can be useful if one wants to inspect various +cgroup files after job completion. Default: false +.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.