[dm-devel] [PATCH] Document queue_if_no_path behavior

[Ritesh Raj Sarraf <rrs researchut com>]

Document the queue_if_no_path behavior in situations where
all the paths to the LUN go offline.

Signed-off-by: Ritesh Raj Sarraf <rrs researchut com>
---
 multipath/multipath.conf.5 |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)

diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5
index c8ab6b0..c66d7fc 100644
--- a/multipath/multipath.conf.5
+++ b/multipath/multipath.conf.5
@@ -374,6 +374,15 @@ section:
 .RE
 .PD
 .LP
+.SH "KNOWN ISSUES"
+The usage of
+.B queue_if_no_path
+option can lead to
+.B D state
+processes being hung and not killable in situations where all the paths to the LUN go offline.
+It is advisable to use the
+.B no_path_retry
+option instead.
 .SH "SEE ALSO"
 .BR udev (8),
 .BR dmsetup (8)
-- 
1.5.3.7