Skip to contentSkip to conversation

Recent changes (master)

PATCH Jens Axboe 1 participant 1 message Jan 12, 2023

lore
Share & tools
lore

Jens Axboe

author
#0 lore raw

The following changes since commit c945074c0336fb1720acead38e578d4dd7f29921:

engines/xnvme: add support for picking mem backend (2022-12-22 08:50:03 -0500)

are available in the Git repository at:

git://git.kernel.dk/fio.git master

for you to fetch changes up to 44834c57f944074684c1b58604cc44199cf5e633:

examples: add missing fiograph diagram for sg_write_same_ndob.fio (2023-01-11 15:22:40 -0500)

----------------------------------------------------------------
Ankit Kumar (1):
doc: clarify the usage of rw_sequencer

Vincent Fu (1):
examples: add missing fiograph diagram for sg_write_same_ndob.fio

 HOWTO.rst                       |  35 ++++++++++++++++++++++++------
 examples/sg_write_same_ndob.png | Bin 0 -> 97793 bytes
 fio.1                           |  47 +++++++++++++++++++++++++++++++++++-----
 3 files changed, 69 insertions(+), 13 deletions(-)
 create mode 100644 examples/sg_write_same_ndob.png

---

Diff of recent changes:

HOWTO.rst +28 -7
index 0a48a453..17caaf5d 100644
@@ -1176,13 +1176,34 @@ I/O type
 			Generate the same offset.
 
 	``sequential`` is only useful for random I/O, where fio would normally
-	generate a new random offset for every I/O. If you append e.g. 8 to randread,
-	you would get a new random offset for every 8 I/Os. The result would be a
-	seek for only every 8 I/Os, instead of for every I/O. Use ``rw=randread:8``
-	to specify that. As sequential I/O is already sequential, setting
-	``sequential`` for that would not result in any differences.  ``identical``
-	behaves in a similar fashion, except it sends the same offset 8 number of
-	times before generating a new offset.
+	generate a new random offset for every I/O. If you append e.g. 8 to
+	randread, i.e. ``rw=randread:8`` you would get a new random offset for
+	every 8 I/Os. The result would be a sequence of 8 sequential offsets
+	with a random starting point. However this behavior may change if a
+	sequential I/O reaches end of the file. As sequential I/O is already
+	sequential, setting ``sequential`` for that would not result in any
+	difference. ``identical`` behaves in a similar fashion, except it sends
+	the same offset 8 number of times before generating a new offset.
+
+	Example #1::
+
+		rw=randread:8
+		rw_sequencer=sequential
+		bs=4k
+
+	The generated sequence of offsets will look like this:
+	4k, 8k, 12k, 16k, 20k, 24k, 28k, 32k, 92k, 96k, 100k, 104k, 108k,
+	112k, 116k, 120k, 48k, 52k ...
+
+	Example #2::
+
+		rw=randread:8
+		rw_sequencer=identical
+		bs=4k
+
+	The generated sequence of offsets will look like this:
+	4k, 4k, 4k, 4k, 4k, 4k, 4k, 4k, 92k, 92k, 92k, 92k, 92k, 92k, 92k, 92k,
+	48k, 48k, 48k ...
 
 .. option:: unified_rw_reporting=str
 
examples/sg_write_same_ndob.png new file binary +0 -0
new file mode 100644
index 00000000..8b76fc6c
Binary files /dev/null and b/examples/sg_write_same_ndob.png differ
fio.1 +41 -6

53 lines not on this page · raw message