From 350a535d23c07b19f6358ac4d7593d0f905f428b Mon Sep 17 00:00:00 2001 From: Dennis Zhou Date: Tue, 2 Oct 2018 22:14:51 -0400 Subject: [PATCH] update replay_align and replay_scale documentation Options replay_align and replay_scale both happen after sector to byte translation. This can cause the offset scaling to be unaligned. Make a note that both options operate on the byte level and replay_align should most likely be used when replay_scale is used. Signed-off-by: Dennis Zhou Signed-off-by: Jens Axboe --- HOWTO | 7 ++++--- fio.1 | 7 ++++--- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/HOWTO b/HOWTO index 95289040..a2503e9a 100644 --- a/HOWTO +++ b/HOWTO @@ -2559,12 +2559,13 @@ I/O replay .. option:: replay_align=int - Force alignment of I/O offsets and lengths in a trace to this power of 2 - value. + Force alignment of the byte offsets in a trace to this value. The value + must be a power of 2. .. option:: replay_scale=int - Scale sector offsets down by this factor when replaying traces. + Scale byte offsets down by this factor when replaying traces. Should most + likely use :option:`replay_align` as well. .. option:: replay_skip=str diff --git a/fio.1 b/fio.1 index 5c11d963..bf181b34 100644 --- a/fio.1 +++ b/fio.1 @@ -2257,11 +2257,12 @@ Unfortunately this also breaks the strict time ordering between multiple device accesses. .TP .BI replay_align \fR=\fPint -Force alignment of I/O offsets and lengths in a trace to this power of 2 -value. +Force alignment of the byte offsets in a trace to this value. The value +must be a power of 2. .TP .BI replay_scale \fR=\fPint -Scale sector offsets down by this factor when replaying traces. +Scale bye offsets down by this factor when replaying traces. Should most +likely use \fBreplay_align\fR as well. .SS "Threads, processes and job synchronization" .TP .BI replay_skip \fR=\fPstr -- 2.25.1