X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=HOWTO;h=6d80360574e0c89899756cbc6a1d9838293c9c81;hp=482d69651c0362c3afd5863512dc32f7d73f3733;hb=03d189b7d77f66ce4f4dba9885d34c7a55ff4e53;hpb=a3f001f5f679ae4efc5f34f682b16a2673ec2bac diff --git a/HOWTO b/HOWTO index 482d6965..6d803605 100644 --- a/HOWTO +++ b/HOWTO @@ -305,6 +305,16 @@ name=str ASCII name of the job. This may be used to override the special purpose of also signaling the start of a new job. +wait_for=str Specifies the name of the already defined job to wait + for. Single waitee name only may be specified. If set, the job + won't be started until all workers of the waitee job are done. + + Wait_for operates on the job name basis, so there are a few + limitations. First, the waitee must be defined prior to the + waiter job (meaning no forward references). Second, if a job + is being referenced as a waitee, it must have a unique name + (no duplicate waitees). + 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. @@ -1003,7 +1013,9 @@ random_generator=str Fio supports the following engines for generating typically good enough. LFSR only works with single block sizes, not with workloads that use multiple block sizes. If used with such a workload, fio may read or write - some blocks multiple times. + some blocks multiple times. The default value is tausworthe, + unless the required space exceeds 2^32 blocks. If it does, + then tausworthe64 is selected automatically. nice=int Run the job with the given nice value. See man nice(2). @@ -1558,8 +1570,12 @@ log_avg_msec=int By default, fio will log an entry in the iops, latency, disk log, that can quickly grow to a very large size. Setting this option makes fio average the each log entry over the specified period of time, reducing the resolution of the log. - Defaults to 0. + See log_max as well. Defaults to 0, logging all entries. +log_max=bool If log_avg_msec is set, fio logs the average over that window. + If you instead want to log the maximum value, set this option + to 1. Defaults to 0, meaning that averaged values are logged. +. 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.