From: Ankit Kumar Date: Wed, 23 Nov 2022 11:27:38 +0000 (+0530) Subject: doc: update about sqthread_poll X-Git-Tag: fio-3.34~82 X-Git-Url: https://git.kernel.dk/?p=fio.git;a=commitdiff_plain;h=72044c66ac7055a98c9b3021c298c81849e3c990 doc: update about sqthread_poll Update that when sqthread_poll is enabled fio will not report submission latency. Signed-off-by: Ankit Kumar Signed-off-by: Vincent Fu --- diff --git a/HOWTO.rst b/HOWTO.rst index bcc3da3a..4419ee1b 100644 --- a/HOWTO.rst +++ b/HOWTO.rst @@ -2299,7 +2299,9 @@ with the caveat that when used on the command line, they must come after the kernel of available items in the SQ ring. If this option is set, the act of submitting IO will be done by a polling thread in the kernel. This frees up cycles for fio, at the cost of using more CPU in the - system. + system. As submission is just the time it takes to fill in the sqe + entries and any syscall required to wake up the idle kernel thread, + fio will not report submission latencies. .. option:: sqthread_poll_cpu=int : [io_uring] [io_uring_cmd] diff --git a/fio.1 b/fio.1 index 9e33c9e1..a156bf5d 100644 --- a/fio.1 +++ b/fio.1 @@ -2090,7 +2090,9 @@ sqthread_poll option. Normally fio will submit IO by issuing a system call to notify the kernel of available items in the SQ ring. If this option is set, the act of submitting IO will be done by a polling thread in the kernel. This frees up cycles for fio, at -the cost of using more CPU in the system. +the cost of using more CPU in the system. As submission is just the time it +takes to fill in the sqe entries and any syscall required to wake up the idle +kernel thread, fio will not report submission latencies. .TP .BI (io_uring,io_uring_cmd)sqthread_poll_cpu \fR=\fPint When `sqthread_poll` is set, this option provides a way to define which CPU