From patchwork Sat Aug 6 22:40:06 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Xose Vazquez Perez X-Patchwork-Id: 9266123 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id E16CE60754 for ; Sat, 6 Aug 2016 22:44:11 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id D24BF28395 for ; Sat, 6 Aug 2016 22:44:11 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id C577D2842D; Sat, 6 Aug 2016 22:44:11 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=2.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, RCVD_IN_DNSWL_HI, T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from mx3-phx2.redhat.com (mx3-phx2.redhat.com [209.132.183.24]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 27E1128395 for ; Sat, 6 Aug 2016 22:44:10 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by mx3-phx2.redhat.com (8.13.8/8.13.8) with ESMTP id u76MeiS4029273; Sat, 6 Aug 2016 18:40:44 -0400 Received: from int-mx10.intmail.prod.int.phx2.redhat.com (int-mx10.intmail.prod.int.phx2.redhat.com [10.5.11.23]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id u76MeNm4015818 for ; Sat, 6 Aug 2016 18:40:23 -0400 Received: from mx1.redhat.com (ext-mx08.extmail.prod.ext.phx2.redhat.com [10.5.110.32]) by int-mx10.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id u76MeNik020310 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO) for ; Sat, 6 Aug 2016 18:40:23 -0400 Received: from mail-wm0-f65.google.com (mail-wm0-f65.google.com [74.125.82.65]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id A85F9C057FAD for ; Sat, 6 Aug 2016 22:40:20 +0000 (UTC) Received: by mail-wm0-f65.google.com with SMTP id i5so9090369wmg.2 for ; Sat, 06 Aug 2016 15:40:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=/QEuyAo3sUfVuLFzh/oKypOZaFcLTQJpCWeMIYDZDXs=; b=lp4/eCsR/ZwS312d3Q3G8p6FL0zr083RzzuZ8gmXRRQgc4DBkuGmQ0BqbexXR121dv fFbDvUiyUMA0KcXSbYsn3R7cOv8fyoWwuJoLtboZfLnABtmLKs6ZJEbI1A/mNjLcZTXg ng66E4KEIa4HdFdTlgtthztwB7vDSxsrJfHNgsetct7uZR0/RPZ03qauwDib0BY3+bw9 +O6970US6LiNg44FQVoP9CeR6cJW1Nhgy/Ur4g4teQri2s3UgU/TrWSFsyYcr4HuM1OW TGu6mBajSiOFQIieFJ05AhUhBzSsy128ObQCYGLABc0pFEpbH/x+1LosY8MnHCkJV/1I NfTA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=/QEuyAo3sUfVuLFzh/oKypOZaFcLTQJpCWeMIYDZDXs=; b=PDyam0XGHzfHQruynogBeKcCX+1FV3NQmAQXlM1ze7sSWjTlQIFXlee+faLAaQa5/T onM0g0ThLPlTpr3RQ+BfOci8060k3s6DNGzg+iRq5RkDI9FgegYkGk3lairx1wT3iTTV ACAdGm0hiPiGliiZta/MxIyWX1gxFSqos4TTbMIuaK3SXUVlvSzLR6QLqhI2KzvpMmV4 bmcLupmAwnVYOSEOkEZzERQTJCZgEzyBRwWY/Dr/lh4MWPpM4ijbtlk/D9qCZWMJGZcM ccfq5XEtkrHfr1AYsqNIGd1MAwdQ3PDAqpOt106Doie5haAoGtcKB14LddqlEJBoj+5e rm1Q== X-Gm-Message-State: AEkoouvKs3cvb0jZ6i2d4xo4IH8TRUkTQBM1hpGonaJY4i9FITGnJC63a0D5b6SHhp6MTA== X-Received: by 10.194.175.38 with SMTP id bx6mr84563838wjc.47.1470523219244; Sat, 06 Aug 2016 15:40:19 -0700 (PDT) Received: from localhost (193.173.78.188.dynamic.jazztel.es. [188.78.173.193]) by smtp.gmail.com with ESMTPSA id m81sm15655847wmf.1.2016.08.06.15.40.17 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 06 Aug 2016 15:40:18 -0700 (PDT) From: Xose Vazquez Perez To: Date: Sun, 7 Aug 2016 00:40:06 +0200 Message-Id: <1470523208-14067-5-git-send-email-xose.vazquez@gmail.com> In-Reply-To: <1470523208-14067-1-git-send-email-xose.vazquez@gmail.com> References: <1470523208-14067-1-git-send-email-xose.vazquez@gmail.com> X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.32]); Sat, 06 Aug 2016 22:40:21 +0000 (UTC) X-Greylist: inspected by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.32]); Sat, 06 Aug 2016 22:40:21 +0000 (UTC) for IP:'74.125.82.65' DOMAIN:'mail-wm0-f65.google.com' HELO:'mail-wm0-f65.google.com' FROM:'xose.vazquez@gmail.com' RCPT:'' X-RedHat-Spam-Score: -0.02 (BAYES_50, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_PASS) 74.125.82.65 mail-wm0-f65.google.com 74.125.82.65 mail-wm0-f65.google.com X-Scanned-By: MIMEDefang 2.68 on 10.5.11.23 X-Scanned-By: MIMEDefang 2.78 on 10.5.110.32 X-loop: dm-devel@redhat.com Cc: device-mapper development , Xose Vazquez Perez Subject: [dm-devel] [PATCH 5/7] multipath-tools: random fixes in multipath.conf.5 X-BeenThere: dm-devel@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: device-mapper development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: dm-devel-bounces@redhat.com Errors-To: dm-devel-bounces@redhat.com X-Virus-Scanned: ClamAV using ClamSMTP Cc: Christophe Varoqui Cc: device-mapper development Signed-off-by: Xose Vazquez Perez --- multipath/multipath.conf.5 | 45 +++++++++++++++++++++++++++------------------ 1 file changed, 27 insertions(+), 18 deletions(-) diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5 index 14a8ccb..4567103 100644 --- a/multipath/multipath.conf.5 +++ b/multipath/multipath.conf.5 @@ -1,3 +1,10 @@ +.\" ---------------------------------------------------------------------------- +.\" Update the date below if you make any significant change. +.\" +.\" TODO: Look for XXX +.\" +.\" ---------------------------------------------------------------------------- +. .TH MULTIPATH.CONF 5 2016-08-06 "Linux" . . @@ -199,9 +206,9 @@ Default value is: \fBfailover\fR The udev attribute providing a unique path identifier. .RS .TP -Default value is: \fBID_SERIAL\fR for SCSI devices +Default value is: for SCSI devices \fBID_SERIAL\fR .TP -Default value is: \fBID_UID\fR for DASD devices +Default value is: for DASD devices \fBID_UID\fR .RE . . @@ -264,9 +271,11 @@ Generate the path priority based on the regular expression and the priority provided as argument. Requires prio_args keyword. .TP .I datacore +.\" XXX ???. Requires prio_args keyword. .TP .I iet +.\" XXX ???. Requires prio_args keyword. .TP Default value is: \fBconst\fR @@ -285,18 +294,19 @@ Needs a value of the form .RS .TP 8 .I hbtl -regex can be of SCSI H:B:T:L format Ex: 1:0:.:. , *:0:0:. +regex can be of SCSI H:B:T:L format. For example: 1:0:.:. , *:0:0:. .TP .I devname -regex can be of device name format Ex: sda , sd.e +regex can be of device name format. For example: sda , sd.e .TP .I serial -regex can be of serial number format Ex: .*J1FR.*324 The serial can be looked up through sysfs or by running multipathd show paths format "%z" Ex: 0395J1FR904324 +regex can be of serial number format. For example: .*J1FR.*324 . The serial can be looked +up through sysfs or by running multipathd show paths format "%z". For example: 0395J1FR904324 .TP .I wwn regex can be of the form \fI"host_wwnn:host_wwpn:target_wwnn:target_wwpn"\fR these values can be looked up through sysfs or by running \fImultipathd show paths format -"%N:%R:%n:%r" Ex: 0x200100e08ba0aea0:0x210100e08ba0aea0:.*:.* , .*:.*:iqn.2009-10.com.redhat.msp.lab.ask-06:.*\fR +"%N:%R:%n:%r". For example: 0x200100e08ba0aea0:0x210100e08ba0aea0:.*:.* , .*:.*:iqn.2009-10.com.redhat.msp.lab.ask-06:.*\fR .RE .TP 12 .I alua @@ -304,9 +314,11 @@ If \fIexclusive_pref_bit\fR is set, paths with the \fIpreferred path\fR bit set will always be in their own path group. .TP .I datacore +.\" XXX \fIpreferredsds\fR ???. .TP .I iet +.\" XXX \fIpreferredip\fR ???. .TP Default value is: \fB\fR @@ -545,8 +557,7 @@ Specify the number of seconds the SCSI layer will wait after a problem has been detected on a FC remote port before removing it from the system. This can be set to "infinity" which sets it to the max value of 2147483647 seconds, or 68 years. It will be automatically adjusted to the overall -retry interval -\fIno_path_retry\fR * \fIpolling_interval\fR +retry interval \fIno_path_retry\fR * \fIpolling_interval\fR if a number of retries is given with \fIno_path_retry\fR and the overall retry interval is longer than the specified \fIdev_loss_tmo\fR value. The Linux kernel will cap this value to \fI300\fR if \fIfast_io_fail_tmo\fR @@ -802,10 +813,9 @@ Default value is: \fB30\fR .SH "blacklist section" .\" ---------------------------------------------------------------------------- . -The \fIblacklist\fR -section is used to exclude specific device from inclusion in the -multipath topology. It is most commonly used to exclude local disks or -LUNs for the array controller. +The \fIblacklist\fR section is used to exclude specific device from inclusion in +the multipath topology. It is most commonly used to exclude local disks or LUNs +for the array controller. .LP . . @@ -834,10 +844,9 @@ keywords. For a full description of these keywords please see the .\" ---------------------------------------------------------------------------- . The \fIblacklist_exceptions\fR section is used to revert the actions of the -\fIblacklist\fR section, for example to include specific device in the +\fIblacklist\fR section. For example to include specific device in the multipath topology. This allows one to selectively include devices which -would normally be excluded via the \fIblacklist\fR -section. +would normally be excluded via the \fIblacklist\fR section. .LP . . @@ -890,8 +899,7 @@ Symbolic name for the multipath map. . . The following attributes are optional; if not set the default values -are taken from the \fIdefaults\fR or \fIdevices\fR -section: +are taken from the \fIdefaults\fR or \fIdevices\fR section: .sp 1 .PD .1v .RS @@ -1139,7 +1147,7 @@ The use of \fIqueue_if_no_path\fR or \fIno_path_retry\fR might lead to a deadlock if the \fIdev_loss_tmo\fR setting results in a device being removed while I/O is still queued. The multipath daemon will update the \fIdev_loss_tmo\fR setting accordingly to avoid this deadlock. Hence if both values are -specified the order of precedence is \fIno_path_retry, queue_if_no_path, dev_loss_tmo.\fR +specified the order of precedence is \fIno_path_retry, queue_if_no_path, dev_loss_tmo\fR. . . .\" ---------------------------------------------------------------------------- @@ -1158,3 +1166,4 @@ specified the order of precedence is \fIno_path_retry, queue_if_no_path, dev_los . \fImultipath-tools\fR was developed by Christophe Varoqui, and others. +.\" EOF