Received: from mail-wm1-f43.google.com (mail-wm1-f43.google.com [209.85.128.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 60249329E6A for ; Sun, 7 Jun 2026 10:38:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.43 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1780828721; cv=none; b=hz8aqwDl2X8qm1VOli7R1gv3CXMtBdJ2HNR9KdB0agW+1MZfytzIoF4IELEcQ1Q8G5KINF3WmG9cSGwFGbfZJ3NDUv631RyJy83CazLm95bX52Obvy7GP9HQvm8WS8WdG3UBWfxdbB4kM+MCkM+TWxlTjSJRR/GJPUOpYnCvTvY= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1780828721; c=relaxed/simple; bh=D4HmTwvaZpFloSCIAg2OWDEC2MjPIYdBkLXO+h9L6aY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=hF5aPOp+ogNZXuWmnOnLJkR4FfG/lp405aROQNQmHfKRKyo/vS+YfBdmYPdVvt7SyDbClIGWZJ3pCgHP3hDvp0RfAk6sIn18upBjMSXMB1QvybF3qHtA5tCuvkKd54UcUiuJyOXVTYR0c1IhE9idqK6vabZDlrM0xoWCL/S4DZA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=KeuDKrLT; arc=none smtp.client-ip=209.85.128.43 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="KeuDKrLT" Received: by mail-wm1-f43.google.com with SMTP id 5b1f17b1804b1-490c737bcafso600045e9.3 for ; Sun, 07 Jun 2026 03:38:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1780828718; x=1781433518; darn=lists.linux.dev; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=zANJzgaOceE3XJAdkvJlLwYtm4O+EYkTvINlGBXXUmU=; b=KeuDKrLTsvYoguZHr7ehZiWbVfifzuNNCtCw7+OBQd89DHG3J99pxj1X/NwmHdJtxD mj2NrkrNTE9nyT6XRFpgL5s9myQn3FDt/pv++1Af9M9DybHc8mKh88/RG+SElQxepztp eRzsBIHISVM+Hik8g9E8A30D2T1Lh0IrgpjydBWRulsEs5xl/affrWHNI8Vi8In/Kto1 gEEQAV/+70AuOZZscCjELjvgAIJfeX/NJwXfVEHQhCNl1vElBmWtDZlvvpNatvqGLX5N ZkKjMFPKMu8QpnBajx+3k1/dmxKhxrBiULHrD5u0GijVlhzObXZs83DqhdMv+xuUy+kJ m2ow== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1780828718; x=1781433518; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=zANJzgaOceE3XJAdkvJlLwYtm4O+EYkTvINlGBXXUmU=; b=oEklkRaBB54i3a3/K/obrExP28S4SMEmagV7QjAtzdA+61OocxpXFgEoPyubY5+Yo2 RVJgnSbzsbl2p+nS86UxHZ/zqRFY4rzZses4Iga6lfWffW75pCr/1yfGhMi6aFVABXXI 4yx5ygOfsvb+lRo0YJE7mvi6PnOY1mWqGGNHvUE3ZXCiG9vx2PW/6/McbeONiWPApeLR VJGZf69ol/zgomvnlTUOfq1AgUGbXdBwhac3SaJm2k0PrwGCk8VuJtDXppw3pCh1u9C7 ew7vhCYwtkUsuP3WXDL+BuUfjAef1hYEunHWqJX4E8W5nuwF0iVExRmv6It/Il9dJO/j UCpA== X-Forwarded-Encrypted: i=1; AFNElJ8RSFRP5PLkdYrXgJwZX3ajBOS4bS0XgcVMpDhbqRgySpxAYHwq5Wa4GHsTukqqBxsfipn2/sY8Ag==@lists.linux.dev X-Gm-Message-State: AOJu0YzGe2FdFwRhiHjeTvKYTyHCwPZWwhn+xYEw+PiAAiTLWJ2FEx+1 6PIEq3SNf1nfZD8EiokeXCjS1N+FMTMEM8QPaa6LjlTqlenLJuCaKvY= X-Gm-Gg: Acq92OHqjRfmlyDBk4Xq0vgWmX5uRt1CDP9td5fFqjGulAfxzoN6VKqWiexv7ECuNOn vPy3iFyWajFmzJqf4XfYHqPQQ40y6HcahpXqoSh1kKXFbI65xH0hU5iK+wHpS1YQpUrj0zyo3O8 Z3/ZkoiovobgmDYekl4S+rfZYAt/RC1LvtvFIU6gzBEWkoyKLwntNIAnEzhK6oj24unzlV9Ph85 pHTcCrfh5FvFjfvZlYnlaHE4S1qMJ44IldOLYzOLGfXXLifCf8rPjk7GbRtFCjhM0L5wVpNiret ckzRBARVsC5OqBIcR/C46Ba+popPjATIRKX6GNbqh2PrNM58dZAKygY9mcuktNc29TMWaXycgdi mq7q0aeUsy8+9UMt7NxoNSeTd783rfQKtNjYMwgTbRqDqdDkJrZGVZl5NQ2i/oRu0wi8vMFhZq/ RDnUrK04xNQkV7JI9OqarYYCgPr910Jyb9HqmPco3YhLZwpP0m6WhbnLl4ukqZeXwVwvFl+70= X-Received: by 2002:a05:600c:4688:b0:490:b2f9:d9a4 with SMTP id 5b1f17b1804b1-490c25985c5mr85530845e9.1.1780828717760; Sun, 07 Jun 2026 03:38:37 -0700 (PDT) Received: from localhost (32.red-80-39-29.staticip.rima-tde.net. [80.39.29.32]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-490c2c9ea37sm320276055e9.0.2026.06.07.03.38.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 07 Jun 2026 03:38:37 -0700 (PDT) From: Xose Vazquez Perez To: Cc: Xose Vazquez Perez , Martin Wilck , Benjamin Marzinski , Christophe Varoqui , DM_DEVEL-ML Subject: [PATCH 2/3] multipath-tools: remove explicit width from .TP macros in multipath.conf.5 Date: Sun, 7 Jun 2026 12:38:22 +0200 Message-ID: <20260607103831.336833-3-xose.vazquez@gmail.com> X-Mailer: git-send-email 2.54.0 In-Reply-To: <20260607103831.336833-1-xose.vazquez@gmail.com> References: <20260607103831.336833-1-xose.vazquez@gmail.com> Precedence: bulk X-Mailing-List: dm-devel@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Patchwork-Bot: notify Content-Transfer-Encoding: 8bit This allows man/groff to calculate the width automatically, preventing excessive whitespace and improving readability on various terminal sizes. Cc: Martin Wilck Cc: Benjamin Marzinski Cc: Christophe Varoqui Cc: DM_DEVEL-ML Signed-off-by: Xose Vazquez Perez --- multipath/multipath.conf.5.in | 56 +++++++++++++++++------------------ 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/multipath/multipath.conf.5.in b/multipath/multipath.conf.5.in index e3a9811c..ef08ed2b 100644 --- a/multipath/multipath.conf.5.in +++ b/multipath/multipath.conf.5.in @@ -103,7 +103,7 @@ matches, standard regular expression syntax using the special characters "^" and .LP . The following \fIsection\fP keywords are recognized: -.TP 17 +.TP .B defaults This section defines default values for attributes which are used whenever no values are given in the appropriate device or multipath @@ -142,7 +142,7 @@ device-specific settings for all devices. The \fIdefaults\fR section recognizes the following keywords: . . -.TP 17 +.TP .B verbosity Default verbosity. Higher values increase the verbosity level. Valid levels are between 0 and 6. @@ -195,7 +195,7 @@ The default is: \fBno\fR The default path selector algorithm to use; they are offered by the kernel multipath target: .RS -.TP 12 +.TP .I "round-robin 0" Choose the path for the next bunch of I/O by looping through every path in the path group, sending \fBthe same number of I/O requests\fR to each path. @@ -223,7 +223,7 @@ The default is: \fBservice-time 0\fR (Hardware-dependent) The default path grouping policy to apply to unspecified multipaths. Possible values are: .RS -.TP 12 +.TP .I failover One path per priority group. .TP @@ -333,7 +333,7 @@ of this path. Higher number have a higher priority. \fI"none"\fR is a valid value. Currently the following path priority routines are implemented: .RS -.TP 12 +.TP .I const Return a constant priority of \fI1\fR. .TP @@ -408,12 +408,12 @@ NetAPP E/EF Series, where it is \fBalua\fR). If \fBdetect_prio\fR is Arguments to pass to to the prio function. This only applies to certain prioritizers: .RS -.TP 12 +.TP .I weighted Needs a value of the form \fI" ..."\fR .RS -.TP 8 +.TP .I hbtl Regex can be of SCSI H:B:T:L format. For example: 1:0:.:. , *:0:0:. .TP @@ -430,11 +430,11 @@ 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"\fR. For example: 0x200100e08ba0aea0:0x210100e08ba0aea0:.*:.* , .*:.*:iqn.2009-10.com.redhat.msp.lab.ask-06:.* .RE -.TP 12 +.TP .I path_latency Needs a value of the form "io_num=\fI<20>\fR base_num=\fI<10>\fR" .RS -.TP 8 +.TP .I io_num The number of read IOs sent to the current path continuously, used to calculate the average path latency. Valid Values: Integer, [20, 200]. @@ -445,7 +445,7 @@ Double-precision floating-point, [1.1, 10]. And Max average latency value is 100 For example: If base_num=10, the paths will be grouped in priority groups with path latency <=1us, (1us, 10us], (10us, 100us], (100us, 1ms], (1ms, 10ms], (10ms, 100ms], (100ms, 1s], (1s, 10s], (10s, 100s], >100s. .RE -.TP 12 +.TP .I alua If \fIexclusive_pref_bit\fR is set, paths with the \fIpreferred path\fR bit set will always be in their own path group. @@ -456,17 +456,17 @@ set will always be in their own path group. .TP .I datacore .RS -.TP 8 +.TP .I preferredsds (Mandatory) The preferred "SDS name". .TP .I timeout (Optional) The timeout for the INQUIRY, in ms. .RE -.TP 12 +.TP .I iet .RS -.TP 8 +.TP .I preferredip=... (Mandatory) Th preferred IP address, in dotted decimal notation, for iSCSI targets. .RE @@ -481,7 +481,7 @@ Specify any device-mapper features to be used. Syntax is \fInum list\fR where \fInum\fR is the number, between 0 and 8, of features in \fIlist\fR. Possible values for the feature list are: .RS -.TP 12 +.TP .I queue_if_no_path (Deprecated, superseded by \fIno_path_retry\fR) Queue I/O if no path is active. Identical to the \fIno_path_retry\fR with \fIqueue\fR value. If both this @@ -520,7 +520,7 @@ to respond. The asynchronous checkers (\fItur\fR and \fIdirectio\fR) will not pause multipathd. Instead, multipathd will check for a response once per second, until \fIchecker_timeout\fR seconds have elapsed. Possible values are: .RS -.TP 12 +.TP .I readsector0 (Deprecated) Read the first sector of the device. This checker is being deprecated, please use \fItur\fR or \fIdirectio\fR instead. @@ -574,7 +574,7 @@ Tell multipathd how to manage path group failback. To select \fIimmediate\fR or a \fIvalue\fR, it's mandatory that the device has support for a working prioritizer. .RS -.TP 12 +.TP .I immediate Immediately failback to the highest priority pathgroup that contains active paths. @@ -628,7 +628,7 @@ The default is: \fBmax\fR .B no_path_retry Specify what to do when all paths are down. Possible values are: .RS -.TP 12 +.TP .I value > 0 Number of retries until disable I/O queueing. .TP @@ -1154,7 +1154,7 @@ blocked from further processing by higher layers - such as LVM - if and only if it\'s considered a valid multipath device path), and b) when multipathd detects a new device. The following values are possible: .RS -.TP 10 +.TP .I strict Both multipath and multipathd treat only such devices as multipath devices which have been part of a multipath map previously, and which are therefore @@ -1421,7 +1421,7 @@ by multipath-tools. . The following keywords are recognized in both sections. The defaults are empty unless explicitly stated. -.TP 17 +.TP .B devnode Regular expression matching the device nodes to be excluded/included. .RS @@ -1511,7 +1511,7 @@ from later entries take precedence. . . The \fImultipath\fR subsection recognizes the following attributes: -.TP 17 +.TP .B wwid (Mandatory) World Wide Identifier. Detected multipath maps are matched against this attribute. Note that, unlike the \fIwwid\fR attribute in the \fIblacklist\fR section, @@ -1530,7 +1530,7 @@ section: .sp 1 .PD .1v .RS -.TP 18 +.TP .B path_grouping_policy .TP .B path_selector @@ -1587,7 +1587,7 @@ section: .SH "devices section" .\" ---------------------------------------------------------------------------- . -.TP 4 +.TP .B Important: The built-in hardware device table of .I multipath-tools @@ -1623,7 +1623,7 @@ for all devices in the system. .LP . The \fIdevice\fR subsection recognizes the following attributes: -.TP 17 +.TP .B vendor (Mandatory) Regular expression to match the vendor name. .RS @@ -1666,7 +1666,7 @@ and \fImultipathd show paths format\fR commands. Currently only the The hardware handler to use for this device type. The following hardware handler are implemented: .RS -.TP 12 +.TP .I 1 emc (Hardware-dependent) Hardware handler for DGC class arrays as CLARiiON CX/AX and EMC VNX families @@ -1707,7 +1707,7 @@ section: .sp 1 .PD .1v .RS -.TP 18 +.TP .B path_grouping_policy .TP .B uid_attribute @@ -1785,7 +1785,7 @@ the values are taken from the \fIdevices\fR or \fIdefaults\fR sections: .sp 1 .PD .1v .RS -.TP 18 +.TP .B path_grouping_policy .TP .B uid_attribute @@ -1899,7 +1899,7 @@ which paths belong to the same device. Each path presenting the same WWID is assumed to point to the same device. .LP The WWID is generated by four methods (in the order of preference): -.TP 17 +.TP .B uid_attrs The WWID is derived from udev attributes by matching the device node name; cf \fIuid_attrs\fR above. @@ -1939,7 +1939,7 @@ pathgroups will not be used until all other pathgroups have been tried. At the time when the path would normally be reinstated, it will be returned to its normal pathgroup. The logic of determining \(dqshaky\(dq condition, as well as the logic when to reinstate, differs between the three methods. -.TP 8 +.TP .B \(dqdelay_checks\(dq failure tracking (Deprecated) This method is \fBdeprecated\fR and mapped to the \(dqsan_path_err\(dq method. See the \fIdelay_watch_checks\fR and \fIdelay_wait_checks\fR options above -- 2.54.0