From patchwork Thu Jan 10 20:50:46 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Benjamin Marzinski X-Patchwork-Id: 1962351 Return-Path: X-Original-To: patchwork-dm-devel@patchwork.kernel.org Delivered-To: patchwork-process-083081@patchwork1.kernel.org Received: from mx4-phx2.redhat.com (mx4-phx2.redhat.com [209.132.183.25]) by patchwork1.kernel.org (Postfix) with ESMTP id 1DF463FF0F for ; Thu, 10 Jan 2013 20:53:11 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by mx4-phx2.redhat.com (8.13.8/8.13.8) with ESMTP id r0AKoobg017158; Thu, 10 Jan 2013 15:50:50 -0500 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 r0AKonOn026543 for ; Thu, 10 Jan 2013 15:50:49 -0500 Received: from ether.msp.redhat.com (ether.msp.redhat.com [10.15.80.119]) by int-mx10.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id r0AKol5X023630 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 10 Jan 2013 15:50:48 -0500 Received: from ether.msp.redhat.com (localhost.localdomain [127.0.0.1]) by ether.msp.redhat.com (8.14.1/8.14.1) with ESMTP id r0AKolPu027122; Thu, 10 Jan 2013 14:50:47 -0600 Received: (from bmarzins@localhost) by ether.msp.redhat.com (8.14.1/8.14.1/Submit) id r0AKok6U027121; Thu, 10 Jan 2013 14:50:46 -0600 Date: Thu, 10 Jan 2013 14:50:46 -0600 From: Benjamin Marzinski To: device-mapper development Message-ID: <20130110205046.GW19059@ether.msp.redhat.com> MIME-Version: 1.0 Content-Disposition: inline User-Agent: Mutt/1.5.17 (2007-11-01) X-Scanned-By: MIMEDefang 2.68 on 10.5.11.23 X-loop: dm-devel@redhat.com Cc: Christophe Varoqui Subject: [dm-devel] [PATCH v2] multipath: update documentation X-BeenThere: dm-devel@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk Reply-To: device-mapper development List-Id: device-mapper development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: dm-devel-bounces@redhat.com Errors-To: dm-devel-bounces@redhat.com Add some missing options to the documentation. Signed-off-by: Benjamin Marzinski --- multipath/main.c | 1 + multipath/multipath.8 | 14 +++++++++++++- multipath/multipath.conf.5 | 31 +++++++++++++++++++++++++++++++ 3 files changed, 45 insertions(+), 1 deletion(-) -- dm-devel mailing list dm-devel@redhat.com https://www.redhat.com/mailman/listinfo/dm-devel Index: multipath-tools-130109/multipath/main.c =================================================================== --- multipath-tools-130109.orig/multipath/main.c +++ multipath-tools-130109/multipath/main.c @@ -101,6 +101,7 @@ usage (char * progname) " -d dry run, do not create or update devmaps\n" \ " -t dump internal hardware table\n" \ " -r force devmap reload\n" \ + " -B treat the bindings file as read only\n" \ " -p policy failover|multibus|group_by_serial|group_by_prio\n" \ " -b fil bindings file location\n" \ " -p pol force all maps to specified path grouping policy :\n" \ Index: multipath-tools-130109/multipath/multipath.8 =================================================================== --- multipath-tools-130109.orig/multipath/multipath.8 +++ multipath-tools-130109/multipath/multipath.8 @@ -5,8 +5,10 @@ multipath \- Device mapper target autoco .B multipath .RB [\| \-v\ \c .IR verbosity \|] +.RB [\| \-b\ \c +.IR bindings_file \|] .RB [\| \-d \|] -.RB [\| \-h | \-l | \-ll | \-f | \-t | \-F \| \-B \|] +.RB [\| \-h | \-l | \-ll | \-f | \-t | \-F | \-B | \-c | \-q | \|-r \|] .RB [\| \-p\ \c .BR failover | multibus | group_by_serial | group_by_prio | group_by_node_name \|] .RB [\| device \|] @@ -56,6 +58,16 @@ force devmap reload .B \-B treat the bindings file as read only .TP +.B \-b " bindings_file" +set user_friendly_names bindings file location. The default is +/etc/multipath/bindings +.TP +.B \-c +check if a block device should be a path in a multipath device +.TP +.B \-q +allow device tables with queue_if_no_path when multipathd is not running +.TP .BI \-p " policy" force new maps to use the specified policy: .RS 1.2i Index: multipath-tools-130109/multipath/multipath.conf.5 =================================================================== --- multipath-tools-130109.orig/multipath/multipath.conf.5 +++ multipath-tools-130109/multipath/multipath.conf.5 @@ -375,6 +375,31 @@ errors are logged at level 3 until the d .I always , multipathd always logs the path checker error at logging level 2. Default is .I always +.TP +.B reservation_key +This is the service action reservation key used by mpathpersist. It must be +set for all multipath devices using persistent reservations, and it must be +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. It is unset by default. +.TP +.B retain_attached_hw_handler +If set to +.I yes +and the scsi layer has already attached a hardware_handler to the device, +multipath will not force the device to use the hardware_handler specified by +mutipath.conf. If the scsi layer has not attached a hardware handler, +multipath will continue to use its configured hardware handler. Default is +.I no +.TP +.B detect_prio +If set to +.I yes +, multipath will try to detect if the device supports ALUA. If so, the device +will automatically use the +.I alua +prioritizer. If not, the prioritizer will be selected as usual. Default is +.I no . .SH "blacklist section" The @@ -474,6 +499,8 @@ section: .B rr_min_io_q .TP .B features +.TP +.B reservation_key .RE .PD .LP @@ -560,6 +587,10 @@ section: .B dev_loss_tmo .TP .B flush_on_last_del +.TP +.B retain_attached_hw_handler +.TP +.B detect_prio .RE .PD .LP