[PATCH v5 1/2] nvme-multipath: apply delayed_removal_secs changes to a pending removal
From: Qiliang Yuan
Date: Thu Nov 19 2026 - 06:07:18 EST
With delayed_removal_secs set, removing the last path of a namespace
head doesn't delete the head right away. nvme_mpath_remove_disk()
queues remove_work with the configured delay, and bios submitted in the
meantime wait on head->requeue_list in case a path comes back.
A write to delayed_removal_secs only takes effect for removals that
start later. A removal that is already pending keeps the old delay, so
clearing the attribute leaves the queued bios waiting until that delay
expires instead of failing them, and lowering or raising it doesn't
move the pending removal either.
Requeue a pending remove_work with the new delay when the attribute is
written, cancelling it first so that the module reference taken for it
carries over. Have nvme_init_ns_head() cancel the pending removal
before it drops subsys->lock rather than after, so that a write to the
attribute cannot requeue the removal once a path is back.
With delayed_removal_secs set and no path left, the attribute is
changed two seconds later and the head is removed after (mean of two
runs, min-max in parentheses):
delay (s) before (ms) after (ms) change
30 -> 0 26655 (26537-26772) 8 (8-8) -99.97%
30 -> 5 28298 (28094-28501) 5514 (5510-5517) -81%
10 -> 30 8112 (8106-8117) 30376 (30106-30646) +274%
A direct read queued before the 30 -> 0 write fails after:
before (ms) after (ms) change
26607 (26450-26764) 4 (4-4) -99.98%
Fixes: 62188639ec160 ("nvme-multipath: introduce delayed removal of the multipath head node")
Suggested-by: Nilay Shroff <nilay@xxxxxxxxxxxxx>
Signed-off-by: Qiliang Yuan <qiliang.yuan@xxxxxxxxx>
---
drivers/nvme/host/core.c | 7 +++++--
drivers/nvme/host/multipath.c | 6 ++++++
2 files changed, 11 insertions(+), 2 deletions(-)
diff --git a/drivers/nvme/host/core.c b/drivers/nvme/host/core.c
index f4aa02869b790..48d432c5d7aeb 100644
--- a/drivers/nvme/host/core.c
+++ b/drivers/nvme/host/core.c
@@ -4231,12 +4231,15 @@ static int nvme_init_ns_head(struct nvme_ns *ns, struct nvme_ns_info *info)
list_add_tail_rcu(&ns->siblings, &head->list);
ns->head = head;
- mutex_unlock(&ctrl->subsys->lock);
-
#ifdef CONFIG_NVME_MULTIPATH
+ /*
+ * Cancel a pending head removal under subsys->lock, so that
+ * delayed_removal_secs_store() never requeues it once a path is back.
+ */
if (cancel_delayed_work(&head->remove_work))
module_put(THIS_MODULE);
#endif
+ mutex_unlock(&ctrl->subsys->lock);
return 0;
out_put_ns_head:
diff --git a/drivers/nvme/host/multipath.c b/drivers/nvme/host/multipath.c
index ae8059366b57d..51c59cc3ea246 100644
--- a/drivers/nvme/host/multipath.c
+++ b/drivers/nvme/host/multipath.c
@@ -1242,6 +1242,12 @@ static ssize_t delayed_removal_secs_store(struct device *dev,
mutex_lock(&head->subsys->lock);
head->delayed_removal_secs = sec;
assign_bit(NVME_NSHEAD_QUEUE_IF_NO_PATH, &head->flags, sec);
+ /*
+ * Apply the new delay to a removal that is still pending. The module
+ * reference taken for it carries over to the requeued work.
+ */
+ if (cancel_delayed_work(&head->remove_work))
+ queue_delayed_work(nvme_wq, &head->remove_work, sec * HZ);
mutex_unlock(&head->subsys->lock);
/*
* Ensure that update to NVME_NSHEAD_QUEUE_IF_NO_PATH is seen
--
2.43.0