From: Frank Meinl <frank.meinl@live.de>
To: dm-devel@redhat.com
Cc: Frank Meinl <frank.meinl@live.de>, mwilck@suse.com
Subject: [PATCH v2 2/2] multipath: Extend program description in manpage
Date: Sat, 26 Sep 2020 18:29:47 +0200 [thread overview]
Message-ID: <AM0PR09MB2897B99544634CA56DA930D1FE370@AM0PR09MB2897.eurprd09.prod.outlook.com> (raw)
In-Reply-To: <AM0PR09MB289702395C44596866E4B9C3FE370@AM0PR09MB2897.eurprd09.prod.outlook.com>
Add two paragraphs which list some advantages of multipath and explain
the benefit for single path devices. The text has been partly composed
by Benjamin Marzinski. - Refer to
https://www.redhat.com/archives/dm-devel/2020-September/msg00431.html
Signed-off-by: Frank Meinl <frank.meinl@live.de>
---
multipath/multipath.8 | 15 ++++++++++++++-
1 file changed, 14 insertions(+), 1 deletion(-)
diff --git a/multipath/multipath.8 b/multipath/multipath.8
index 5b29a5d9..a580630a 100644
--- a/multipath/multipath.8
+++ b/multipath/multipath.8
@@ -89,7 +89,20 @@ multipath \- Device mapper target autoconfig.
.\" ----------------------------------------------------------------------------
.
.B multipath
-is used to detect and coalesce multiple paths to devices, for fail-over or performance reasons.
+is used to detect and coalesce multiple paths to devices, for fail-over or
+performance reasons.
+.PP
+.B multipath
+works with devices as they are, instead of needing special metadata, like
+\fBlvm\fR devices. Plus, multipath deals with devices that have partitions or
+logical volumes on top of them. Consequently, multipath can be easily employed
+after the device is already set up, without the need to alter logical volumes
+or partition tables.
+.PP
+Despite its name, \fBmultipath\fR may be useful for single path devices, too.
+It offers the possibility to queue I/O if no path to the physical device is
+available. With queuing, a running application may tolerate a temporary device
+disconnect, because outstanding I/O will not fail immediately.
.
.\" ----------------------------------------------------------------------------
.SH ARGUMENTS
--
2.25.1
next prev parent reply other threads:[~2020-09-26 16:29 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-09-26 16:26 [PATCH v2 1/2] libmultipath: Allow discovery of USB devices Frank Meinl
2020-09-26 16:29 ` Frank Meinl [this message]
2020-09-26 19:02 ` [PATCH v2 2/2] multipath: Extend program description in manpage Martin Wilck
2020-09-28 19:13 ` Frank Meinl
2020-09-26 18:54 ` [PATCH v2 1/2] libmultipath: Allow discovery of USB devices Martin Wilck
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=AM0PR09MB2897B99544634CA56DA930D1FE370@AM0PR09MB2897.eurprd09.prod.outlook.com \
--to=frank.meinl@live.de \
--cc=dm-devel@redhat.com \
--cc=mwilck@suse.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).