From: Dennis Zhou Date: Wed, 3 Oct 2018 02:14:51 +0000 (-0400) Subject: update replay_align and replay_scale documentation X-Git-Tag: fio-3.11~2 X-Git-Url: https://git.kernel.dk/?a=commitdiff_plain;h=350a535d23c07b19f6358ac4d7593d0f905f428b;p=fio.git 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 --- 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