Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 81781C54EBE for ; Thu, 12 Jan 2023 20:29:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1673555346; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=zm0oqnH7JKRfr77mVR7d5yLv5YovIegE2T/jrO67B0I=; b=EMqTzktcKUrSw3Or7d1hVqGhSRwpNBQYoXUsqk7/TWEhOEiWvsozJw4n5aL+W/2CbcepX/ 1ySTAvyiANAcIOE/JwOpstZBKOycIh6hmpL36BgG0jYh6caeDDGj4jjdqgrUdYAXcOh2WL qA/lt955LMUwGWhySntC3m8/sMF9sDQ= Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-176-d8mKWUqKN72jR6u3TAFQPg-1; Thu, 12 Jan 2023 15:29:02 -0500 X-MC-Unique: d8mKWUqKN72jR6u3TAFQPg-1 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.rdu2.redhat.com [10.11.54.2]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 5BD88857A84; Thu, 12 Jan 2023 20:29:01 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id E06354078904; Thu, 12 Jan 2023 20:28:54 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 83640194704F; Thu, 12 Jan 2023 20:28:54 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 21E691946A78 for ; Thu, 12 Jan 2023 20:28:53 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id EAF391759E; Thu, 12 Jan 2023 20:28:52 +0000 (UTC) Received: from octiron.msp.redhat.com (octiron.msp.redhat.com [10.15.80.209]) by smtp.corp.redhat.com (Postfix) with ESMTPS id C967B51E5; Thu, 12 Jan 2023 20:28:52 +0000 (UTC) Received: from octiron.msp.redhat.com (localhost.localdomain [127.0.0.1]) by octiron.msp.redhat.com (8.14.9/8.14.9) with ESMTP id 30CKSpCH009894; Thu, 12 Jan 2023 14:28:51 -0600 Received: (from bmarzins@localhost) by octiron.msp.redhat.com (8.14.9/8.14.9/Submit) id 30CKSp7G009893; Thu, 12 Jan 2023 14:28:51 -0600 From: Benjamin Marzinski To: Christophe Varoqui Date: Thu, 12 Jan 2023 14:28:48 -0600 Message-Id: <1673555329-9850-2-git-send-email-bmarzins@redhat.com> In-Reply-To: <1673555329-9850-1-git-send-email-bmarzins@redhat.com> References: <1673555329-9850-1-git-send-email-bmarzins@redhat.com> X-Scanned-By: MIMEDefang 3.1 on 10.11.54.5 Subject: [dm-devel] [PATCH 1/2] multipathd: Add format options to multipathd man page X-BeenThere: dm-devel@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: device-mapper development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: device-mapper development , Nitin Yewale , Martin Wilck MIME-Version: 1.0 Errors-To: dm-devel-bounces@redhat.com Sender: "dm-devel" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.2 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit From: Nitin Yewale Move "multipathd show wildcards" command above the $format commands and also add $format options for "map" and "path" commands to the multipathd man page. Signed-off-by: Benjamin Marzinski --- multipathd/multipathd.8 | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/multipathd/multipathd.8 b/multipathd/multipathd.8 index bdf102eb..95d475da 100644 --- a/multipathd/multipathd.8 +++ b/multipathd/multipathd.8 @@ -113,9 +113,17 @@ The following commands can be used in interactive mode: Show the paths that multipathd is monitoring, and their state. . .TP +.B list|show wildcards +Show the format wildcards used in interactive commands taking $format. +. +.TP .B list|show paths format $format Show the paths that multipathd is monitoring, using a format string with path format wildcards. + +path format wildcards: + +%w (uuid), %i (hcil), %d (dev), %D (dev_t), %t (dm_st), %o (dev_st), %T (chk_st), %s (vend/prod/rev), %c (checker), %C (next_check), %p (pri), %S (size), %z (serial), %M (marginal_st), %m (multipath), %N (host WWNN), %n (target WWNN), %R (host WWPN), %r (target WWPN), %a (host adapter), %G (foreign), %g (vpd page data), %0 (failures), %P (protocol) . .TP .B list|show maps|multipaths @@ -125,6 +133,10 @@ Show the multipath devices that the multipathd is monitoring. .B list|show maps|multipaths format $format Show the status of all multipath devices that the multipathd is monitoring, using a format string with multipath format wildcards. + +multipath format wildcards: + +%n (name), %w (uuid), %d (sysfs), %F (failback), %Q (queueing), %N (no. of paths), %r (write_prot), %t (dm-st), %S (size), %f (features), %x (failures), %h (hwhandler), %A (action), %0 (path_faults), %1 (switch_grp), %2 (map_loads), %3 (total_q_time), %4 (q_timeouts), %s (vend/prod/rev), %v (vend), %p (prod), %e (rev), %G (foreign), %g (vpd page data) . .TP .B list|show maps|multipaths status @@ -148,10 +160,6 @@ Show topology of a single multipath device specified by $map, for example 36005076303ffc56200000000000010aa. This map could be obtained from '\fIlist maps\fR'. . .TP -.B list|show wildcards -Show the format wildcards used in interactive commands taking $format. -. -.TP .B list|show config Show the currently used configuration, derived from default values and values specified within the configuration file \fI/etc/multipath.conf\fR. -- 2.17.2 -- dm-devel mailing list dm-devel@redhat.com https://listman.redhat.com/mailman/listinfo/dm-devel