summaryrefslogtreecommitdiffstats
path: root/Documentation/block
diff options
context:
space:
mode:
authorJens Axboe <axboe@fb.com>2016-11-17 22:23:02 -0700
committerJens Axboe <axboe@fb.com>2016-11-17 22:23:02 -0700
commit10e6246e2275865ab917494e418f44b8c25ddd34 (patch)
tree0ddb3e847eb2cb335792f9163fd9a7fcd3ca6ee4 /Documentation/block
parent542ff7bf18c63cf403e36a4a1c71d86dc120d924 (diff)
downloadlinux-stable-10e6246e2275865ab917494e418f44b8c25ddd34.tar.gz
linux-stable-10e6246e2275865ab917494e418f44b8c25ddd34.tar.bz2
linux-stable-10e6246e2275865ab917494e418f44b8c25ddd34.zip
block: document the 'io_poll_delay' queue sysfs file
This was documented in the original commit, 64f1c21e86f7, but it never made it into the proper location for queue sysfs files. Signed-off-by: Jens Axboe <axboe@fb.com>
Diffstat (limited to 'Documentation/block')
-rw-r--r--Documentation/block/queue-sysfs.txt14
1 files changed, 14 insertions, 0 deletions
diff --git a/Documentation/block/queue-sysfs.txt b/Documentation/block/queue-sysfs.txt
index 87abf1ac2939..14235e72a702 100644
--- a/Documentation/block/queue-sysfs.txt
+++ b/Documentation/block/queue-sysfs.txt
@@ -58,6 +58,20 @@ When read, this file shows the total number of block IO polls and how
many returned success. Writing '0' to this file will disable polling
for this device. Writing any non-zero value will enable this feature.
+io_poll_delay (RW)
+------------------
+If polling is enabled, this controls what kind of polling will be
+performed. It defaults to -1, which is classic polling. In this mode,
+the CPU will repeatedly ask for completions without giving up any time.
+If set to 0, a hybrid polling mode is used, where the kernel will attempt
+to make an educated guess at when the IO will complete. Based on this
+guess, the kernel will put the process issuing IO to sleep for an amount
+of time, before entering a classic poll loop. This mode might be a
+little slower than pure classic polling, but it will be more efficient.
+If set to a value larger than 0, the kernel will put the process issuing
+IO to sleep for this amont of microseconds before entering classic
+polling.
+
iostats (RW)
-------------
This file is used to control (on/off) the iostats accounting of the