|
 |
ca7c20 |
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
|
ca7c20 |
From: Benjamin Marzinski <bmarzins@redhat.com>
|
|
|
ca7c20 |
Date: Wed, 13 Apr 2022 23:27:41 -0500
|
|
|
ca7c20 |
Subject: [PATCH] libmultipath: Add documentation for the protocol subsection
|
|
|
ca7c20 |
|
|
|
ca7c20 |
Signed-off-by: Benjamin Marzinski <bmarzins@redhat.com>
|
|
|
ca7c20 |
Reviewed-by: Martin Wilck <mwilck@suse.com>
|
|
|
ca7c20 |
---
|
|
|
ca7c20 |
multipath/multipath.conf.5 | 32 ++++++++++++++++++++++++++++++++
|
|
|
ca7c20 |
1 file changed, 32 insertions(+)
|
|
|
ca7c20 |
|
|
|
ca7c20 |
diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5
|
|
|
ca7c20 |
index 47404545..f7de5140 100644
|
|
|
ca7c20 |
--- a/multipath/multipath.conf.5
|
|
|
ca7c20 |
+++ b/multipath/multipath.conf.5
|
|
|
ca7c20 |
@@ -1765,6 +1765,38 @@ the values are taken from the \fIdevices\fR or \fIdefaults\fR sections:
|
|
|
ca7c20 |
.RE
|
|
|
ca7c20 |
.PD
|
|
|
ca7c20 |
.LP
|
|
|
ca7c20 |
+The overrides section also recognizes the optional \fIprotocol\fR subsection,
|
|
|
ca7c20 |
+and can contain multiple protocol subsections. Path devices are matched against
|
|
|
ca7c20 |
+the protocol subsection using the mandatory \fItype\fR attribute. Attributes
|
|
|
ca7c20 |
+in a matching protocol subsection take precedence over attributes in the rest
|
|
|
ca7c20 |
+of the overrides section. If there are multiple matching protocol subsections,
|
|
|
ca7c20 |
+later entries take precedence.
|
|
|
ca7c20 |
+.TP
|
|
|
ca7c20 |
+.B protocol subsection
|
|
|
ca7c20 |
+The protocol subsection recognizes the following mandatory attribute:
|
|
|
ca7c20 |
+.RS
|
|
|
ca7c20 |
+.TP
|
|
|
ca7c20 |
+.B type
|
|
|
ca7c20 |
+The protocol string of the path device. The possible values are \fIscsi:fcp\fR,
|
|
|
ca7c20 |
+\fIscsi:spi\fR, \fIscsi:ssa\fR, \fIscsi:sbp\fR, \fIscsi:srp\fR,
|
|
|
ca7c20 |
+\fIscsi:iscsi\fR, \fIscsi:sas\fR, \fIscsi:adt\fR, \fIscsi:ata\fR,
|
|
|
ca7c20 |
+\fIscsi:unspec\fR, \fIccw\fR, \fIcciss\fR, \fInvme\fR, and \fIundef\fR. This is
|
|
|
ca7c20 |
+\fBnot\fR a regular expression. the path device protcol string must match
|
|
|
ca7c20 |
+exactly. The protocol that a path is using can be viewed by running
|
|
|
ca7c20 |
+\fBmultipathd show paths format "%d %P"\fR
|
|
|
ca7c20 |
+.LP
|
|
|
ca7c20 |
+The following attributes are optional; if not set, the default values are taken
|
|
|
ca7c20 |
+from the \fIoverrides\fR, \fIdevices\fR, or \fIdefaults\fR section:
|
|
|
ca7c20 |
+.sp 1
|
|
|
ca7c20 |
+.PD .1v
|
|
|
ca7c20 |
+.RS
|
|
|
ca7c20 |
+.TP
|
|
|
ca7c20 |
+.B fast_io_fail_tmo
|
|
|
ca7c20 |
+.TP
|
|
|
ca7c20 |
+.B dev_loss_tmo
|
|
|
ca7c20 |
+.TP
|
|
|
ca7c20 |
+.B eh_deadline
|
|
|
ca7c20 |
+.PD
|
|
|
ca7c20 |
.
|
|
|
ca7c20 |
.
|
|
|
ca7c20 |
.\" ----------------------------------------------------------------------------
|