Re: [PATCH v2 01/14] nvmet: Rapid Path Failure Recovery set controller identify fields

Mohamed Khalfella
2026-02-03T18:15:06Z

On Tue 2026-02-03 04:03:22 +0100, Hannes Reinecke wrote:
> On 1/30/26 23:34, Mohamed Khalfella wrote:
> > TP8028 Rapid Path Failure Recovery defined new fields in controller
> > identify response. The newly defined fields are:
> >
> > - CIU (Controller Instance UNIQUIFIER): is an 8bit non-zero value that
> > is assigned a random value when controller first created. The value is
> > expected to be incremented when RDY bit in CSTS register is asserted
> > - CIRN (Controller Instance Random Number): is 64bit random value that
> > gets generated when controller is crated. CIRN is regenerated everytime
> > RDY bit is CSTS register is asserted.
> > - CCRL (Cross-Controller Reset Limit) is an 8bit value that defines the
> > maximum number of in-progress controller reset operations. CCRL is
> > hardcoded to 4 as recommended by TP8028.
> >
> > TP4129 KATO Corrections and Clarifications defined CQT (Command Quiesce
> > Time) which is used along with KATO (Keep Alive Timeout) to set an upper
> > time limit for attempting Cross-Controller Recovery. For NVME subsystem
> > CQT is set to 0 by default to keep the current behavior. The value can
> > be set from configfs if needed.
> >
> > Make the new fields available for IO controllers only since TP8028 is
> > not very useful for discovery controllers.
> >
> > Signed-off-by: Mohamed Khalfella <mkhalfella@purestorage.com>
> > ---
> > drivers/nvme/target/admin-cmd.c | 6 ++++++
> > drivers/nvme/target/configfs.c | 31 +++++++++++++++++++++++++++++++
> > drivers/nvme/target/core.c | 12 ++++++++++++
> > drivers/nvme/target/nvmet.h | 4 ++++
> > include/linux/nvme.h | 15 ++++++++++++---
> > 5 files changed, 65 insertions(+), 3 deletions(-)
> >
> > diff --git a/drivers/nvme/target/admin-cmd.c b/drivers/nvme/target/admin-cmd.c
> > index 3da31bb1183e..ade1145df72d 100644
> > --- a/drivers/nvme/target/admin-cmd.c
> > +++ b/drivers/nvme/target/admin-cmd.c
> > @@ -696,6 +696,12 @@ static void nvmet_execute_identify_ctrl(struct nvmet_req *req)
> >
> > id->cntlid = cpu_to_le16(ctrl->cntlid);
> > id->ver = cpu_to_le32(ctrl->subsys->ver);
> > + if (!nvmet_is_disc_subsys(ctrl->subsys)) {
> > + id->cqt = cpu_to_le16(ctrl->cqt);
> > + id->ciu = ctrl->ciu;
> > + id->cirn = cpu_to_le64(ctrl->cirn);
> > + id->ccrl = NVMF_CCR_LIMIT;
> > + }
> >
> > /* XXX: figure out what to do about RTD3R/RTD3 */
> > id->oaes = cpu_to_le32(NVMET_AEN_CFG_OPTIONAL);
> > diff --git a/drivers/nvme/target/configfs.c b/drivers/nvme/target/configfs.c
> > index e44ef69dffc2..035f6e75a818 100644
> > --- a/drivers/nvme/target/configfs.c
> > +++ b/drivers/nvme/target/configfs.c
> > @@ -1636,6 +1636,36 @@ static ssize_t nvmet_subsys_attr_pi_enable_store(struct config_item *item,
> > CONFIGFS_ATTR(nvmet_subsys_, attr_pi_enable);
> > #endif
> >
> > +static ssize_t nvmet_subsys_attr_cqt_show(struct config_item *item,
> > + char *page)
> > +{
> > + return snprintf(page, PAGE_SIZE, "%u\n", to_subsys(item)->cqt);
> > +}
> > +
> > +static ssize_t nvmet_subsys_attr_cqt_store(struct config_item *item,
> > + const char *page, size_t cnt)
> > +{
> > + struct nvmet_subsys *subsys = to_subsys(item);
> > + struct nvmet_ctrl *ctrl;
> > + u16 cqt;
> > +
> > + if (sscanf(page, "%hu\n", &cqt) != 1)
> > + return -EINVAL;
> > +
> > + down_write(&nvmet_config_sem);
> > + if (subsys->cqt == cqt)
> > + goto out;
> > +
> > + subsys->cqt = cqt;
> > + /* Force reconnect */
> > + list_for_each_entry(ctrl, &subsys->ctrls, subsys_entry)
> > + ctrl->ops->delete_ctrl(ctrl);
> > +out:
> > + up_write(&nvmet_config_sem);
> > + return cnt;
> > +}
> > +CONFIGFS_ATTR(nvmet_subsys_, attr_cqt);
> > +
> > static ssize_t nvmet_subsys_attr_qid_max_show(struct config_item *item,
> > char *page)
> > {
> > @@ -1676,6 +1706,7 @@ static struct configfs_attribute *nvmet_subsys_attrs[] = {
> > &nvmet_subsys_attr_attr_vendor_id,
> > &nvmet_subsys_attr_attr_subsys_vendor_id,
> > &nvmet_subsys_attr_attr_model,
> > + &nvmet_subsys_attr_attr_cqt,
> > &nvmet_subsys_attr_attr_qid_max,
> > &nvmet_subsys_attr_attr_ieee_oui,
> > &nvmet_subsys_attr_attr_firmware,
>
> I do think that TP8028 (ie the CQT defintions) are somewhat independent
> on CCR. So I'm not sure if they should be integrated in this patchset;
> personally I would prefer to have it moved to another patchset.

Agreed that CQT is not directly related to CCR from the target
perspective. But there is a relationship when it comes to how the
initiator uses CQT to calculate the time budget for CCR. As you know on
the host side if CCR fails and CQT is supported the requests needs to be
held for certain amount of time before they are retried. So CQT value is
needed and that I why I included it in this patchset.

>
> > diff --git a/drivers/nvme/target/core.c b/drivers/nvme/target/core.c
> > index cc88e5a28c8a..0d2a1206e08f 100644
> > --- a/drivers/nvme/target/core.c
> > +++ b/drivers/nvme/target/core.c
> > @@ -1393,6 +1393,10 @@ static void nvmet_start_ctrl(struct nvmet_ctrl *ctrl)
> > return;
> > }
> >
> > + if (!nvmet_is_disc_subsys(ctrl->subsys)) {
> > + ctrl->ciu = ((u8)(ctrl->ciu + 1)) ? : 1;
> > + ctrl->cirn = get_random_u64();
> > + }
> > ctrl->csts = NVME_CSTS_RDY;
> >
> > /*
> > @@ -1661,6 +1665,12 @@ struct nvmet_ctrl *nvmet_alloc_ctrl(struct nvmet_alloc_ctrl_args *args)
> > }
> > ctrl->cntlid = ret;
> >
> > + if (!nvmet_is_disc_subsys(ctrl->subsys)) {
> > + ctrl->cqt = subsys->cqt;
> > + ctrl->ciu = get_random_u8() ? : 1;
> > + ctrl->cirn = get_random_u64();
> > + }
> > +
> > /*
> > * Discovery controllers may use some arbitrary high value
> > * in order to cleanup stale discovery sessions
> > @@ -1853,10 +1863,12 @@ struct nvmet_subsys *nvmet_subsys_alloc(const char *subsysnqn,
> >
> > switch (type) {
> > case NVME_NQN_NVME:
> > + subsys->cqt = NVMF_CQT_MS;
> > subsys->max_qid = NVMET_NR_QUEUES;
> > break;
>
> And I would not set the CQT default here.
> Thing is, implementing CQT to the letter would inflict a CQT delay
> during failover for _every_ installation, thereby resulting in a
> regression to previous implementations where we would fail over
> with _no_ delay.
> So again, we should make it a different patchset.

CQT defaults to 0 to avoid introducing surprise delay. The initiator will
skip holding requests if it sees CQT set to 0.