From patchwork Wed Nov 8 00:15:12 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Benjamin Marzinski X-Patchwork-Id: 10047381 X-Patchwork-Delegate: christophe.varoqui@free.fr 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 3307C60247 for ; Wed, 8 Nov 2017 00:15:41 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 2461F28CBD for ; Wed, 8 Nov 2017 00:15:41 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 18D6D292C4; Wed, 8 Nov 2017 00:15:41 +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.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id BCA8028CBD for ; Wed, 8 Nov 2017 00:15:40 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id A7DDC806A9; Wed, 8 Nov 2017 00:15:39 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com A7DDC806A9 Authentication-Results: ext-mx02.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx02.extmail.prod.ext.phx2.redhat.com; spf=fail smtp.mailfrom=dm-devel-bounces@redhat.com Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 6FE8E5D9CD; Wed, 8 Nov 2017 00:15:39 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 42AFD4BB79; Wed, 8 Nov 2017 00:15:39 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id vA80FcdQ008959 for ; Tue, 7 Nov 2017 19:15:38 -0500 Received: by smtp.corp.redhat.com (Postfix) id 31BE464446; Wed, 8 Nov 2017 00:15:38 +0000 (UTC) Delivered-To: dm-devel@redhat.com Received: from redhat.com (octiron.msp.redhat.com [10.15.80.209]) by smtp.corp.redhat.com (Postfix) with SMTP id E80A964447; Wed, 8 Nov 2017 00:15:34 +0000 (UTC) Received: by redhat.com (sSMTP sendmail emulation); Tue, 07 Nov 2017 18:15:34 -0600 From: "Benjamin Marzinski" To: device-mapper development Date: Tue, 7 Nov 2017 18:15:12 -0600 Message-Id: <1510100116-6206-3-git-send-email-bmarzins@redhat.com> In-Reply-To: <1510100116-6206-1-git-send-email-bmarzins@redhat.com> References: <1510100116-6206-1-git-send-email-bmarzins@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-loop: dm-devel@redhat.com Cc: Martin Wilck Subject: [dm-devel] [PATCH 2/6] multipath: add man page info for my prkey changes 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-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.26]); Wed, 08 Nov 2017 00:15:40 +0000 (UTC) X-Virus-Scanned: ClamAV using ClamSMTP Update the man pages to list the new configuration options and multipathd commands. Signed-off-by: Benjamin Marzinski --- multipath/multipath.conf.5 | 17 +++++++++++++++++ multipathd/multipathd.8 | 16 ++++++++++++++++ 2 files changed, 33 insertions(+) diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5 index 5b6dde7..92ad8b1 100644 --- a/multipath/multipath.conf.5 +++ b/multipath/multipath.conf.5 @@ -682,6 +682,17 @@ The default is: \fB/etc/multipath/wwids\fR . . .TP +.B prkeys_file +The full pathname of the prkeys file, which is used by multipathd to keep +track of the persistent reservation key used for a specific WWID, when +\fIreservation_key\fR is set to \fBfile\fR. +.RS +.TP +The default is \fB/etc/multipath/prkeys\fR +.RE +. +. +.TP .B log_checker_err If set to .I once @@ -703,6 +714,12 @@ the same as the RESERVATION KEY field of the PERSISTENT RESERVE OUT parameter list which contains an 8-byte value provided by the application client to the device server to identify the I_T nexus. .RS +.PP +Alternatively, this can be set to \fBfile\fR, which will store the RESERVATION +KEY registered by mpathpersist in the \fIprkeys_file\fR. multipathd will then +use this key to register additional paths as they appear. When the +registration is removed, the RESERVATION KEY is removed from the +\fIprkeys_file\fR. .TP The default is: \fB\fR .RE diff --git a/multipathd/multipathd.8 b/multipathd/multipathd.8 index 2615728..5c96680 100644 --- a/multipathd/multipathd.8 +++ b/multipathd/multipathd.8 @@ -247,6 +247,22 @@ Disable persistent reservation management on $map. Get the current persistent reservation management status of $map. . .TP +.B map|multipath $map getprkey +Get the current persistent reservation key associated with $map. +. +.TP +.B map|multipath $map setprkey key $key +Set the persistent reservation key associated with $map to $key in the +\fIprkeys_file\fR. This key will only be used by multipathd if +\fIreservation_key\fR is set to \fBfile\fR in \fI/etc/multipath.conf\fR. +. +.TP +.B map|multipath $map unsetprkey +Remove the persistent reservation key associated with $map from the +\fIprkeys_file\fR. This will only unset the key used by multipathd if +\fIreservation_key\fR is set to \fBfile\fR in \fI/etc/multipath.conf\fR. +. +.TP .B quit|exit End interactive session. .