942c9b6ed8
Update Source to upstream version 0.8.2 * Previoud patches 0001-0017 & 0027 are included in this commit Rename files * Previous patches 0018-0026 & 0028 are not patches 0021-0030 Add 0001-libmultipath-make-vector_foreach_slot_backwards-work.patch Add 0002-libmultipath-add-marginal-paths-and-groups-infrastru.patch Add 0003-tests-add-path-grouping-policy-unit-tests.patch Add 0004-libmultipath-add-wrapper-function-around-pgpolicyfn.patch Add 0005-tests-update-pgpolicy-tests-to-work-with-group_paths.patch Add 0006-libmultipath-fix-double-free-in-pgpolicyfn-error-pat.patch Add 0007-libmultipath-consolidate-group_by_-functions.patch Add 0008-libmultipath-make-pgpolicyfn-take-a-paths-vector.patch Add 0009-libmultipath-make-group_paths-handle-marginal-paths.patch Add 0010-tests-add-tests-for-grouping-marginal-paths.patch Add 0011-libmultipath-add-marginal_pathgroups-config-option.patch Add 0012-libmutipath-deprecate-delay_-_checks.patch Add 0013-multipathd-use-marginal_pathgroups.patch Add 0014-multipath-update-man-pages.patch * The above 13 patches add the marinal_pathgroups option Add 0015-multipath.conf-add-enable_foreign-parameter.patch Add 0016-multipath.conf.5-document-foreign-library-support.patch * The above 2 patches add the enable_foreign option Add 0017-mpathpersist-remove-broken-unused-code.patch Add 0018-libmultipath-EMC-PowerMax-NVMe-device-config.patch Add 0019-mpathpersist-fix-leaks.patch Add 0020-libmultipath-fix-mpcontext-initialization.patch * The above 20 patches have been submitted upstream
76 lines
2.7 KiB
Diff
76 lines
2.7 KiB
Diff
From 1439bf7acc88b6a398e1a390045dcac9e3163e53 Mon Sep 17 00:00:00 2001
|
|
From: Martin Wilck <mwilck@suse.com>
|
|
Date: Thu, 15 Aug 2019 14:46:56 +0000
|
|
Subject: [PATCH] multipath.conf.5: document foreign library support
|
|
|
|
Add documentation for foreign library support, and for the
|
|
"enable_foreign" parameter.
|
|
|
|
Signed-off-by: Martin Wilck <mwilck@suse.com>
|
|
Signed-off-by: Benjamin Marzinski <bmarzins@redhat.com>
|
|
---
|
|
multipath/multipath.conf.5 | 40 ++++++++++++++++++++++++++++++++++++++
|
|
1 file changed, 40 insertions(+)
|
|
|
|
diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5
|
|
index ac8eadd0..101e1a88 100644
|
|
--- a/multipath/multipath.conf.5
|
|
+++ b/multipath/multipath.conf.5
|
|
@@ -1222,6 +1222,21 @@ makes multipath immediately mark a device with only ghost paths as ready.
|
|
The default is: \fBno\fR
|
|
.RE
|
|
.
|
|
+.
|
|
+.TP
|
|
+.B enable_foreign
|
|
+Enables or disables foreign libraries (see section
|
|
+.I FOREIGN MULTIPATH SUPPORT
|
|
+below). The value is a regular expression; foreign libraries are loaded
|
|
+if their name (e.g. \(dqnvme\(dq) matches the expression. By default,
|
|
+all foreign libraries are enabled.
|
|
+.RS
|
|
+.TP
|
|
+The default is: \fB\(dq\(dq\fR (the empty regular expression)
|
|
+.RE
|
|
+.
|
|
+.
|
|
+
|
|
.
|
|
.\" ----------------------------------------------------------------------------
|
|
.SH "blacklist and blacklist_exceptions sections"
|
|
@@ -1765,6 +1780,31 @@ unpredictable ways. If the \(dqmarginal_path\(dq method is active, the
|
|
.
|
|
.
|
|
.\" ----------------------------------------------------------------------------
|
|
+.SH "FOREIGN MULTIPATH SUPPORT"
|
|
+.\" ----------------------------------------------------------------------------
|
|
+.
|
|
+multipath and multipathd can load \(dqforeign\(dq libraries to add
|
|
+support for other multipathing technologies besides the Linux device mapper.
|
|
+Currently this support is limited to printing detected information about
|
|
+multipath setup. In topology output, the names of foreign maps are prefixed by
|
|
+the foreign library name in square brackets, as in this example:
|
|
+.
|
|
+.P
|
|
+.EX
|
|
+# multipath -ll
|
|
+uuid.fedcba98-3579-4567-8765-123456789abc [nvme]:nvme4n9 NVMe,Some NVMe controller,FFFFFFFF
|
|
+size=167772160 features='n/a' hwhandler='ANA' wp=rw
|
|
+|-+- policy='n/a' prio=50 status=optimized
|
|
+| `- 4:38:1 nvme4c38n1 0:0 n/a optimized live
|
|
+`-+- policy='n/a' prio=50 status=optimized
|
|
+ `- 4:39:1 nvme4c39n1 0:0 n/a optimized live
|
|
+.EE
|
|
+.
|
|
+.P
|
|
+The \(dqnvme\(dq foreign library provides support for NVMe native multipathing
|
|
+in the kernel. It is part of the standard multipath package.
|
|
+.
|
|
+.\" ----------------------------------------------------------------------------
|
|
.SH "KNOWN ISSUES"
|
|
.\" ----------------------------------------------------------------------------
|
|
.
|
|
--
|
|
2.17.2
|
|
|