[PATCH v3 6/8] nvme: set discard_granularity from NPDG/NPDA

From: Caleb Sander Mateos

Date: Tue Feb 24 2026 - 12:20:54 EST


Currently, nvme_config_discard() always sets the discard_granularity
queue limit to the logical block size. However, NVMe namespaces can
advertise a larger preferred discard granularity in the NPDG or NPDA
field of the Identify Namespace structure or the NPDGL or NPDAL fields
of the I/O Command Set Specific Identify Namespace structure.

Use these fields to compute the discard_granularity limit. The logic is
somewhat involved. First, the fields are optional. NPDG is only reported
if the low bit of OPTPERF is set in NSFEAT. NPDA is reported if any bit
of OPTPERF is set. And NPDGL and NPDAL are reported if the high bit of
OPTPERF is set. NPDGL and NPDAL can also each be set to 0 to opt out of
reporting a limit. I/O Command Set Specific Identify Namespace may also
not be supported by older NVMe controllers. Another complication is that
multiple values may be reported among NPDG, NPDGL, NPDA, and NPDAL. The
spec says to prefer the values reported in the L variants. The spec says
NPDG should be a multiple of NPDA and NPDGL should be a multiple of
NPDAL, but it doesn't specify a relationship between NPDG and NPDAL or
NPDGL and NPDA. So use the maximum of the reported NPDG(L) and NPDA(L)
values as the discard_granularity.

Signed-off-by: Caleb Sander Mateos <csander@xxxxxxxxxxxxxxx>
---
drivers/nvme/host/core.c | 33 ++++++++++++++++++++++++++++++---
1 file changed, 30 insertions(+), 3 deletions(-)

diff --git a/drivers/nvme/host/core.c b/drivers/nvme/host/core.c
index 2b433478f328..a9e8936b480d 100644
--- a/drivers/nvme/host/core.c
+++ b/drivers/nvme/host/core.c
@@ -2055,16 +2055,17 @@ static void nvme_set_ctrl_limits(struct nvme_ctrl *ctrl,
lim->max_segment_size = UINT_MAX;
lim->dma_alignment = 3;
}

static bool nvme_update_disk_info(struct nvme_ns *ns, struct nvme_id_ns *id,
- struct queue_limits *lim)
+ struct nvme_id_ns_nvm *nvm, struct queue_limits *lim)
{
struct nvme_ns_head *head = ns->head;
struct nvme_ctrl *ctrl = ns->ctrl;
u32 bs = 1U << head->lba_shift;
u32 atomic_bs, phys_bs, io_opt = 0;
+ u32 npdg = 1, npda = 1;
bool valid = true;
u8 optperf;

/*
* The block layer can't support LBA sizes larger than the page size
@@ -2113,11 +2114,37 @@ static bool nvme_update_disk_info(struct nvme_ns *ns, struct nvme_id_ns *id,
else if (ctrl->oncs & NVME_CTRL_ONCS_DSM)
lim->max_hw_discard_sectors = UINT_MAX;
else
lim->max_hw_discard_sectors = 0;

- lim->discard_granularity = lim->logical_block_size;
+ /*
+ * NVMe namespaces advertise both a preferred deallocate granularity
+ * (for a discard length) and alignment (for a discard starting offset).
+ * However, Linux block devices advertise a single discard_granularity.
+ * From NVM Command Set specification 1.1 section 5.2.2, the NPDGL/NPDAL
+ * fields in the NVM Command Set Specific Identify Namespace structure
+ * are preferred to NPDG/NPDA in the Identify Namespace structure since
+ * they can represent larger values. However, NPDGL or NPDAL may be 0 if
+ * unsupported. NPDG and NPDA are 0's based.
+ * From Figure 115 of NVM Command Set specification 1.1, NPDGL and NPDAL
+ * are supported if the high bit of OPTPERF is set. NPDG is supported if
+ * the low bit of OPTPERF is set. NPDA is supported if either is set.
+ * NPDG should be a multiple of NPDA, and likewise NPDGL should be a
+ * multiple of NPDAL, but the spec doesn't say anything about NPDG vs.
+ * NPDAL or NPDGL vs. NPDA. So compute the maximum instead of assuming
+ * NPDG(L) is the larger. If neither NPDG, NPDGL, NPDA, nor NPDAL are
+ * supported, default the discard_granularity to the logical block size.
+ */
+ if (optperf & 0x2 && nvm && nvm->npdgl)
+ npdg = le32_to_cpu(nvm->npdgl);
+ else if (optperf & 0x1)
+ npdg = from0based(id->npdg);
+ if (optperf & 0x2 && nvm && nvm->npdal)
+ npda = le32_to_cpu(nvm->npdal);
+ else if (optperf)
+ npda = from0based(id->npda);
+ lim->discard_granularity = max(npdg, npda) * lim->logical_block_size;

if (ctrl->dmrl)
lim->max_discard_segments = ctrl->dmrl;
else
lim->max_discard_segments = NVME_DSM_MAX_RANGES;
@@ -2380,11 +2407,11 @@ static int nvme_update_ns_info_block(struct nvme_ns *ns,
ns->head->nuse = le64_to_cpu(id->nuse);
capacity = nvme_lba_to_sect(ns->head, le64_to_cpu(id->nsze));
nvme_set_ctrl_limits(ns->ctrl, &lim, false);
nvme_configure_metadata(ns->ctrl, ns->head, id, nvm, info);
nvme_set_chunk_sectors(ns, id, &lim);
- if (!nvme_update_disk_info(ns, id, &lim))
+ if (!nvme_update_disk_info(ns, id, nvm, &lim))
capacity = 0;

if (IS_ENABLED(CONFIG_BLK_DEV_ZONED) &&
ns->head->ids.csi == NVME_CSI_ZNS)
nvme_update_zone_info(ns, &lim, &zi);
--
2.45.2