<div dir="ltr"><div>Hello Ben,</div><div><br></div>I can try to explain the $format options. Will update bz with the new patch.<div><br></div><div>Thank you,</div><div>Nitin Yewale</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Jan 13, 2023 at 2:22 PM Martin Wilck <<a href="mailto:martin.wilck@suse.com">martin.wilck@suse.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Thu, 2023-01-12 at 14:28 -0600, Benjamin Marzinski wrote:<br>
> From: Nitin Yewale <<a href="mailto:nyewale@redhat.com" target="_blank">nyewale@redhat.com</a>><br>
> <br>
> Move "multipathd show wildcards" command above the $format commands<br>
> and<br>
> also add $format options for "map" and "path" commands to the<br>
> multipathd<br>
> man page.<br>
> <br>
> Signed-off-by: Benjamin Marzinski <<a href="mailto:bmarzins@redhat.com" target="_blank">bmarzins@redhat.com</a>><br>
> ---<br>
>  multipathd/multipathd.8 | 16 ++++++++++++----<br>
>  1 file changed, 12 insertions(+), 4 deletions(-)<br>
> <br>
> diff --git a/multipathd/multipathd.8 b/multipathd/multipathd.8<br>
> index bdf102eb..95d475da 100644<br>
> --- a/multipathd/multipathd.8<br>
> +++ b/multipathd/multipathd.8<br>
> @@ -113,9 +113,17 @@ The following commands can be used in<br>
> interactive mode:<br>
>  Show the paths that multipathd is monitoring, and their state.<br>
>  .<br>
>  .TP<br>
> +.B list|show wildcards<br>
> +Show the format wildcards used in interactive commands taking<br>
> $format.<br>
> +.<br>
> +.TP<br>
>  .B list|show paths format $format<br>
>  Show the paths that multipathd is monitoring, using a format string<br>
> with path<br>
>  format wildcards.<br>
> +<br>
> +path format wildcards:<br>
> +<br>
> +%w (uuid), %i (hcil), %d (dev), %D (dev_t), %t (dm_st), %o (dev_st),<br>
> %T (chk_st), %s (vend/prod/rev), %c (checker), %C (next_check), %p<br>
> (pri), %S (size), %z (serial), %M (marginal_st), %m (multipath), %N<br>
> (host WWNN), %n (target WWNN), %R (host WWPN), %r (target WWPN), %a<br>
> (host adapter), %G (foreign), %g (vpd page data), %0 (failures), %P<br>
> (protocol)<br>
>  .<br>
<br>
If we do this in the first place, we should explain it better. Terms<br>
like "dm_st" need explanation. The explanation would grow into a longer<br>
paragraph, which should be moved to the bottom of the man page with a<br>
cross reference here.<br>
<br>
>  .TP<br>
>  .B list|show maps|multipaths<br>
> @@ -125,6 +133,10 @@ Show the multipath devices that the multipathd<br>
> is monitoring.<br>
>  .B list|show maps|multipaths format $format<br>
>  Show the status of all multipath devices that the multipathd is<br>
> monitoring,<br>
>  using a format string with multipath format wildcards.<br>
> +<br>
> +multipath format wildcards:<br>
> +<br>
> +%n (name), %w (uuid), %d (sysfs), %F (failback), %Q (queueing), %N<br>
> (no. of paths), %r (write_prot), %t (dm-st), %S (size), %f<br>
> (features), %x (failures), %h (hwhandler), %A (action), %0<br>
> (path_faults), %1 (switch_grp), %2 (map_loads), %3 (total_q_time), %4<br>
> (q_timeouts), %s (vend/prod/rev), %v (vend), %p (prod), %e (rev), %G<br>
> (foreign), %g (vpd page data)<br>
<br>
Same comment as above.<br>
<br>
Martin<br>
<br>
>  .<br>
>  .TP<br>
>  .B list|show maps|multipaths status<br>
> @@ -148,10 +160,6 @@ Show topology of a single multipath device<br>
> specified by $map, for example<br>
>  36005076303ffc56200000000000010aa. This map could be obtained from<br>
> '\fIlist maps\fR'.<br>
>  .<br>
>  .TP<br>
> -.B list|show wildcards<br>
> -Show the format wildcards used in interactive commands taking<br>
> $format.<br>
> -.<br>
> -.TP<br>
>  .B list|show config<br>
>  Show the currently used configuration, derived from default values<br>
> and values<br>
>  specified within the configuration file \fI/etc/multipath.conf\fR.<br>
<br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div>Regards,</div></div></div>