Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 6a421c1d authored by Aaron Carroll's avatar Aaron Carroll Committed by Jens Axboe
Browse files

block: update documentation for deadline fifo_batch tunable



Update the description of fifo_batch to match the current implementation,
and include a description of how to tune it.

Signed-off-by: default avatarAaron Carroll <aaronc@gelato.unsw.edu.au>
Signed-off-by: default avatarJens Axboe <jens.axboe@oracle.com>
parent 4fb72f76
Loading
Loading
Loading
Loading
+10 −4
Original line number Diff line number Diff line
@@ -30,12 +30,18 @@ write_expire (in ms)
Similar to read_expire mentioned above, but for writes.


fifo_batch
fifo_batch	(number of requests)
----------

When a read request expires its deadline, we must move some requests from
the sorted io scheduler list to the block device dispatch queue. fifo_batch
controls how many requests we move.
Requests are grouped into ``batches'' of a particular data direction (read or
write) which are serviced in increasing sector order.  To limit extra seeking,
deadline expiries are only checked between batches.  fifo_batch controls the
maximum number of requests per batch.

This parameter tunes the balance between per-request latency and aggregate
throughput.  When low latency is the primary concern, smaller is better (where
a value of 1 yields first-come first-served behaviour).  Increasing fifo_batch
generally improves throughput, at the cost of latency variation.


writes_starved	(number of dispatches)