X-Git-Url: https://git.kernel.dk/?a=blobdiff_plain;f=HOWTO;h=3001fe74a0b6cffe19fba612e95c082580085c01;hb=ae5888523480f094ce04375a45797e111273ab22;hp=1c89d75f29cf6a01264d9f6dbbaaefc9b529a9e8;hpb=370c2c87bcb4dbcff279fe7235752ed97a04dcab;p=fio.git diff --git a/HOWTO b/HOWTO index 1c89d75f..3001fe74 100644 --- a/HOWTO +++ b/HOWTO @@ -81,7 +81,7 @@ $ fio job_file and it will start doing what the job_file tells it to do. You can give more than one job file on the command line, fio will serialize the running of those files. Internally that is the same as using the 'stonewall' -parameter described the the parameter section. +parameter described in the parameter section. If the job file contains only one job, you may as well just give the parameters on the command line. The command line parameters are identical @@ -424,10 +424,10 @@ size=int The total size of file io for this job. Fio will run until Unless specific nrfiles and filesize options are given, fio will divide this size between the available files specified by the job. If not set, fio will use the full - size of the given files or devices. If the the files - do not exist, size must be given. It is also possible to - give size as a percentage between 1 and 100. If size=20% - is given, fio will use 20% of the full size of the given + size of the given files or devices. If the files do not + exist, size must be given. It is also possible to give + size as a percentage between 1 and 100. If size=20% is + given, fio will use 20% of the full size of the given files or devices. io_limit=int Normally fio operates within the region set by 'size', which @@ -1333,6 +1333,9 @@ log_avg_msec=int By default, fio will log an entry in the iops, latency, specified period of time, reducing the resolution of the log. Defaults to 0. +log_offset=int If this is set, the iolog options will include the byte + offset for the IO entry as well as the other data values. + lockmem=int Pin down the specified amount of memory with mlock(2). Can potentially be used instead of removing memory or booting with less memory to simulate a smaller amount of memory. @@ -1607,6 +1610,15 @@ _ Thread reaped, or X Thread reaped, exited with an error. K Thread reaped, exited due to signal. +Fio will condense the thread string as not to take up more space on the +command line as is needed. For instance, if you have 10 readers and 10 +writers running, the output would look like this: + +Jobs: 20 (f=20): [R(10),W(10)] [4.0% done] [2103MB/0KB/0KB /s] [538K/0/0 iops] [eta 57m:36s] + +Fio will still maintain the ordering, though. So the above means that jobs +1..10 are readers, and 11..20 are writers. + The other values are fairly self explanatory - number of threads currently running and doing io, rate of io since last check (read speed listed first, then write speed), and the estimated completion percentage