multipath-tools: clarify path selector descriptions in multipath.conf.5
PATCH v3 5/8 multipath-tools: clarify path selector descriptions in multipath.conf.5
Selectors operate on the next individual I/O request rather than a "bunch" of I/O.
Suggested-by Benjamin Marzinski <[email protected]>
Cc Martin Wilck <[email protected]>
Cc Benjamin Marzinski <[email protected]>
Cc Christophe Varoqui <[email protected]>
Cc DM_DEVEL-ML <[email protected]>
Signed-off-by Xose Vazquez Perez <[email protected]>
---
v2: fix typo, s/group/groups (spotted by Martin)
v3: revert v2, "group" makes more sense. (spotted by Ben)
multipath/multipath.conf.5.in | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-)
multipath/multipath.conf.5.in +5 -7
@@ -2,7 +2,7 @@ .\" Update the date below if you make any significant change. .\" ---------------------------------------------------------------------------- . -.TH MULTIPATH.CONF 5 2026-05-27 Linux +.TH MULTIPATH.CONF 5 2026-06-13 Linux . . .\" ----------------------------------------------------------------------------
@@ -193,20 +193,18 @@ kernel multipath target: .RS .TP .I "round-robin 0" -Choose the path for the next bunch of I/O by looping through every path in the -path group, sending \fBthe same number of I/O requests\fR to each path. - +Choose the path for the next I/O request by \fBcycling through the path group\fR. .TP .I "queue-length 0" -(Since 2.6.31 kernel) Choose the path for the next bunch of I/O based on \fBthe lowest +(Since 2.6.31 kernel) Choose the path for the next I/O request based on \fBthe lowest number of outstanding in-flight I/O requests\fR to the path. .TP .I "service-time 0" -(Since 2.6.31 kernel) Choose the path for the next bunch of I/O based on \fBthe +(Since 2.6.31 kernel) Choose the path for the next I/O request based on \fBthe lowest total size (in bytes) of outstanding in-flight I/O requests\fR to the path. .TP .I "historical-service-time 0" -(Since 5.8 kernel) Choose the path for the next bunch of I/O with \fBa dynamic +(Since 5.8 kernel) Choose the path for the next I/O request with \fBa dynamic algorithm based on the historical service time and the number of outstanding in-flight I/O requests\fR to the path. .TP
Signature · 1 line
2.54.0
Quoted 9 lines · Xose Vazquez Perez
Selectors operate on the next individual I/O request rather than a "bunch" of I/O.
Suggested-by Benjamin Marzinski <[email protected]>Cc Martin Wilck <[email protected]>Cc Benjamin Marzinski <[email protected]>Cc Christophe Varoqui <[email protected]>Cc DM_DEVEL-ML <[email protected]>Signed-off-by Xose Vazquez Perez <[email protected]>
Quoted 3 lines
---
v2: fix typo, s/group/groups (spotted by Martin)
v3: revert v2, "group" makes more sense. (spotted by Ben)
Reviewed-by Benjamin Marzinski <[email protected]>
Quoted 44 lines
multipath/multipath.conf.5.in | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-)multipath/multipath.conf.5.in +5
-7@@ -2,7 +2,7 @@ .\" Update the date below if you make any significant change. .\" ---------------------------------------------------------------------------- . -.TH MULTIPATH.CONF 5 2026-05-27 Linux +.TH MULTIPATH.CONF 5 2026-06-13 Linux . . .\" ----------------------------------------------------------------------------@@ -193,20 +193,18 @@ kernel multipath target: .RS .TP .I "round-robin 0" -Choose the path for the next bunch of I/O by looping through every path in the -path group, sending \fBthe same number of I/O requests\fR to each path. - +Choose the path for the next I/O request by \fBcycling through the path group\fR. .TP .I "queue-length 0" -(Since 2.6.31 kernel) Choose the path for the next bunch of I/O based on \fBthe lowest +(Since 2.6.31 kernel) Choose the path for the next I/O request based on \fBthe lowest number of outstanding in-flight I/O requests\fR to the path. .TP .I "service-time 0" -(Since 2.6.31 kernel) Choose the path for the next bunch of I/O based on \fBthe +(Since 2.6.31 kernel) Choose the path for the next I/O request based on \fBthe lowest total size (in bytes) of outstanding in-flight I/O requests\fR to the path. .TP .I "historical-service-time 0" -(Since 5.8 kernel) Choose the path for the next bunch of I/O with \fBa dynamic +(Since 5.8 kernel) Choose the path for the next I/O request with \fBa dynamic algorithm based on the historical service time and the number of outstanding in-flight I/O requests\fR to the path. .TPSignature · 1 line
2.54.0