Documentation: block: ioprio: Update schedulers

Message ID cde50a18-7c09-4d00-b3b8-32da2992c952@arm.com
State New
Headers
Series Documentation: block: ioprio: Update schedulers |

Commit Message

Christian Loehle Jan. 17, 2024, 12:20 p.m. UTC
  This doc hasn't been touched in a while, in the meantime some
new io schedulers were added (e.g. all of mq), some with ioprio
support.

Signed-off-by: Christian Loehle <christian.loehle@arm.com>
---
 Documentation/block/ioprio.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)
  

Comments

Johannes Thumshirn Jan. 17, 2024, 12:49 p.m. UTC | #1
On 17.01.24 13:20, Christian Loehle wrote:
> This doc hasn't been touched in a while, in the meantime some
> new io schedulers were added (e.g. all of mq), some with ioprio
> support.
> 
> Signed-off-by: Christian Loehle <christian.loehle@arm.com>
> ---
>   Documentation/block/ioprio.rst | 8 ++++----
>   1 file changed, 4 insertions(+), 4 deletions(-)
> 
> diff --git a/Documentation/block/ioprio.rst b/Documentation/block/ioprio.rst
> index a25c6d5df87b..5410308888d2 100644
> --- a/Documentation/block/ioprio.rst
> +++ b/Documentation/block/ioprio.rst
> @@ -9,14 +9,14 @@ Intro
>   With the introduction of cfq v3 (aka cfq-ts or time sliced cfq), basic io
>   priorities are supported for reads on files.  This enables users to io nice
>   processes or process groups, similar to what has been possible with cpu
> -scheduling for ages.  This document mainly details the current possibilities
> -with cfq; other io schedulers do not support io priorities thus far.
> +scheduling for ages. Support for io priorities is io scheduler dependent and
> +currently supported by bfq, mq-deadline and cfq.

CFQ went away with blk-mq and got replaced by BFQ IIRC.


>   
>   Scheduling classes
>   ------------------
>   
> -CFQ implements three generic scheduling classes that determine how io is
> -served for a process.
> +Three generic scheduling classes are implemented for io priorities that
> +determine how io is served for a process.
>   
>   IOPRIO_CLASS_RT: This is the realtime io class. This scheduling class is given
>   higher priority than any other in the system, processes from this class are
  
Christian Loehle Jan. 17, 2024, 3:11 p.m. UTC | #2
On 17/01/2024 12:49, Johannes Thumshirn wrote:
> On 17.01.24 13:20, Christian Loehle wrote:
>> This doc hasn't been touched in a while, in the meantime some
>> new io schedulers were added (e.g. all of mq), some with ioprio
>> support.
>>
>> Signed-off-by: Christian Loehle <christian.loehle@arm.com>
>> ---
>>   Documentation/block/ioprio.rst | 8 ++++----
>>   1 file changed, 4 insertions(+), 4 deletions(-)
>>
>> diff --git a/Documentation/block/ioprio.rst b/Documentation/block/ioprio.rst
>> index a25c6d5df87b..5410308888d2 100644
>> --- a/Documentation/block/ioprio.rst
>> +++ b/Documentation/block/ioprio.rst
>> @@ -9,14 +9,14 @@ Intro
>>   With the introduction of cfq v3 (aka cfq-ts or time sliced cfq), basic io
>>   priorities are supported for reads on files.  This enables users to io nice
>>   processes or process groups, similar to what has been possible with cpu
>> -scheduling for ages.  This document mainly details the current possibilities
>> -with cfq; other io schedulers do not support io priorities thus far.
>> +scheduling for ages. Support for io priorities is io scheduler dependent and
>> +currently supported by bfq, mq-deadline and cfq.
> 
> CFQ went away with blk-mq and got replaced by BFQ IIRC.

Right, I'll remove the mentioning of CFQ here and in the introductory sentence.
The introductory sentence also mentions "basic io priorities are supported for
reads on files", a limitation which hasn't been there in a long time.
Thanks, will send out v2 tomorrow.

> 
> 
>>   
>>   Scheduling classes
>>   ------------------
>>   
>> -CFQ implements three generic scheduling classes that determine how io is
>> -served for a process.
>> +Three generic scheduling classes are implemented for io priorities that
>> +determine how io is served for a process.
>>   
>>   IOPRIO_CLASS_RT: This is the realtime io class. This scheduling class is given
>>   higher priority than any other in the system, processes from this class are
>
  

Patch

diff --git a/Documentation/block/ioprio.rst b/Documentation/block/ioprio.rst
index a25c6d5df87b..5410308888d2 100644
--- a/Documentation/block/ioprio.rst
+++ b/Documentation/block/ioprio.rst
@@ -9,14 +9,14 @@  Intro
 With the introduction of cfq v3 (aka cfq-ts or time sliced cfq), basic io
 priorities are supported for reads on files.  This enables users to io nice
 processes or process groups, similar to what has been possible with cpu
-scheduling for ages.  This document mainly details the current possibilities
-with cfq; other io schedulers do not support io priorities thus far.
+scheduling for ages. Support for io priorities is io scheduler dependent and
+currently supported by bfq, mq-deadline and cfq.
 
 Scheduling classes
 ------------------
 
-CFQ implements three generic scheduling classes that determine how io is
-served for a process.
+Three generic scheduling classes are implemented for io priorities that
+determine how io is served for a process.
 
 IOPRIO_CLASS_RT: This is the realtime io class. This scheduling class is given
 higher priority than any other in the system, processes from this class are