X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=HOWTO;h=78fa6ccf4a61e623a44c0e1137f46cc416382ee8;hp=dc99e9989a47a262cc432ef8f5507acd6e54c85a;hb=62b858f646ad4fce971fbde21ff4859ec84bc281;hpb=59466396a8f7d37ca7884aaacf591cb9a894a336

diff --git a/HOWTO b/HOWTO
index dc99e998..78fa6ccf 100644
--- a/HOWTO
+++ b/HOWTO
@@ -173,7 +173,16 @@ Command line options
 .. option:: --eta=when
 
 	Specifies when real-time ETA estimate should be printed.  `when` may be
-	`always`, `never` or `auto`.
+	`always`, `never` or `auto`. `auto` is the default, it prints ETA
+	when requested if the output is a TTY. `always` disregards the output
+	type, and prints ETA when requested. `never` never prints ETA.
+
+.. option:: --eta-interval=time
+
+	By default, fio requests client ETA status roughly every second. With
+	this option, the interval is configurable. Fio imposes a minimum
+	allowed time to avoid flooding the console, less than 250 msec is
+	not supported.
 
 .. option:: --eta-newline=time
 
@@ -1293,6 +1302,9 @@ I/O type
 
 		random_distribution=zoned_abs=60/20G:30/100G:10/500g
 
+	For both **zoned** and **zoned_abs**, fio supports defining up to
+	256 separate zones.
+
 	Similarly to how :option:`bssplit` works for setting ranges and
 	percentages of block sizes. Like :option:`bssplit`, it's possible to
 	specify separate zones for reads, writes, and trims. If just one set
@@ -1388,34 +1400,39 @@ Block size
 
 .. option:: bssplit=str[,str][,str]
 
-	Sometimes you want even finer grained control of the block sizes issued, not
-	just an even split between them.  This option allows you to weight various
-	block sizes, so that you are able to define a specific amount of block sizes
-	issued. The format for this option is::
+	Sometimes you want even finer grained control of the block sizes
+	issued, not just an even split between them.  This option allows you to
+	weight various block sizes, so that you are able to define a specific
+	amount of block sizes issued. The format for this option is::
 
 		bssplit=blocksize/percentage:blocksize/percentage
 
-	for as many block sizes as needed. So if you want to define a workload that
-	has 50% 64k blocks, 10% 4k blocks, and 40% 32k blocks, you would write::
+	for as many block sizes as needed. So if you want to define a workload
+	that has 50% 64k blocks, 10% 4k blocks, and 40% 32k blocks, you would
+	write::
 
 		bssplit=4k/10:64k/50:32k/40
 
-	Ordering does not matter. If the percentage is left blank, fio will fill in
-	the remaining values evenly. So a bssplit option like this one::
+	Ordering does not matter. If the percentage is left blank, fio will
+	fill in the remaining values evenly. So a bssplit option like this one::
 
 		bssplit=4k/50:1k/:32k/
 
-	would have 50% 4k ios, and 25% 1k and 32k ios. The percentages always add up
-	to 100, if bssplit is given a range that adds up to more, it will error out.
+	would have 50% 4k ios, and 25% 1k and 32k ios. The percentages always
+	add up to 100, if bssplit is given a range that adds up to more, it
+	will error out.
 
 	Comma-separated values may be specified for reads, writes, and trims as
 	described in :option:`blocksize`.
 
-	If you want a workload that has 50% 2k reads and 50% 4k reads, while having
-	90% 4k writes and 10% 8k writes, you would specify::
+	If you want a workload that has 50% 2k reads and 50% 4k reads, while
+	having 90% 4k writes and 10% 8k writes, you would specify::
 
 		bssplit=2k/50:4k/50,4k/90,8k/10
 
+	Fio supports defining up to 64 different weights for each data
+	direction.
+
 .. option:: blocksize_unaligned, bs_unaligned
 
 	If set, fio will issue I/O units with any size within
@@ -2200,6 +2217,13 @@ I/O rate
 	(https://en.wikipedia.org/wiki/Poisson_point_process). The lambda will be
 	10^6 / IOPS for the given workload.
 
+.. option:: rate_ignore_thinktime=bool
+
+	By default, fio will attempt to catch up to the specified rate setting,
+	if any kind of thinktime setting was used. If this option is set, then
+	fio will ignore the thinktime and continue doing IO at the specified
+	rate, instead of entering a catch-up mode after thinktime is done.
+
 
 I/O latency
 ~~~~~~~~~~~
@@ -2950,20 +2974,20 @@ Measurements and reporting
 
 .. option:: percentile_list=float_list
 
-	Overwrite the default list of percentiles for completion latencies and the
-	block error histogram.  Each number is a floating number in the range
-	(0,100], and the maximum length of the list is 20. Use ``:`` to separate the
-	numbers, and list the numbers in ascending order. For example,
-	``--percentile_list=99.5:99.9`` will cause fio to report the values of
-	completion latency below which 99.5% and 99.9% of the observed latencies
-	fell, respectively.
+	Overwrite the default list of percentiles for completion latencies and
+	the block error histogram.  Each number is a floating number in the
+	range (0,100], and the maximum length of the list is 20. Use ``:`` to
+	separate the numbers, and list the numbers in ascending order. For
+	example, ``--percentile_list=99.5:99.9`` will cause fio to report the
+	values of completion latency below which 99.5% and 99.9% of the observed
+	latencies fell, respectively.
 
 .. option:: significant_figures=int
 
-	If using :option:`--output-format` of `normal`, set the significant figures 
-	to this	value. Higher values will yield more precise IOPS and throughput 
-	units, while lower values will round. Requires a minimum value of 1 and a 
-	maximum value of 10. Defaults to 4.
+	If using :option:`--output-format` of `normal`, set the significant
+	figures to this	value. Higher values will yield more precise IOPS and
+	throughput units, while lower values will round. Requires a minimum
+	value of 1 and a maximum value of 10. Defaults to 4.
 
 
 Error handling