[RFC PATCH v4 14/27] nvme-tcp-offload: Add IO level implementation

Shai Malin malin1024 at gmail.com
Tue May 4 17:34:37 BST 2021


On 5/1/21 7:38 PM, Hannes Reinecke wrote:
> On 4/29/21 9:09 PM, Shai Malin wrote:
> > From: Dean Balandin <dbalandin at marvell.com>
> >
> > In this patch, we present the IO level functionality.
> > The nvme-tcp-offload shall work on the IO-level, meaning the
> > nvme-tcp-offload ULP module shall pass the request to the nvme-tcp-offload
> > vendor driver and shall expect for the request compilation.
>
> Request compilation? Not request completion?

Completion. Thanks!

>
> > No additional handling is needed in between, this design will reduce the
> > CPU utilization as we will describe below.
> >
> > The nvme-tcp-offload vendor driver shall register to nvme-tcp-offload ULP
> > with the following IO-path ops:
> >   - init_req
> >   - send_req - in order to pass the request to the handling of the offload
> >     driver that shall pass it to the vendor specific device
> >   - poll_queue
> >
> > The vendor driver will manage the context from which the request will be
> > executed and the request aggregations.
> > Once the IO completed, the nvme-tcp-offload vendor driver shall call
> > command.done() that shall invoke the nvme-tcp-offload ULP layer for
> > completing the request.
> >
> > This patch also contains initial definition of nvme_tcp_ofld_queue_rq().
> >
> > Acked-by: Igor Russkikh <irusskikh at marvell.com>
> > Signed-off-by: Dean Balandin <dbalandin at marvell.com>
> > Signed-off-by: Prabhakar Kushwaha <pkushwaha at marvell.com>
> > Signed-off-by: Omkar Kulkarni <okulkarni at marvell.com>
> > Signed-off-by: Michal Kalderon <mkalderon at marvell.com>
> > Signed-off-by: Ariel Elior <aelior at marvell.com>
> > Signed-off-by: Shai Malin <smalin at marvell.com>
> > ---
> >   drivers/nvme/host/tcp-offload.c | 95 ++++++++++++++++++++++++++++++---
> >   1 file changed, 87 insertions(+), 8 deletions(-)
> >
> > diff --git a/drivers/nvme/host/tcp-offload.c b/drivers/nvme/host/tcp-offload.c
> > index 8ddce2257100..0cdf5a432208 100644
> > --- a/drivers/nvme/host/tcp-offload.c
> > +++ b/drivers/nvme/host/tcp-offload.c
> > @@ -127,7 +127,10 @@ void nvme_tcp_ofld_req_done(struct nvme_tcp_ofld_req *req,
> >                           union nvme_result *result,
> >                           __le16 status)
> >   {
> > -     /* Placeholder - complete request with/without error */
> > +     struct request *rq = blk_mq_rq_from_pdu(req);
> > +
> > +     if (!nvme_try_complete_req(rq, cpu_to_le16(status << 1), *result))
> > +             nvme_complete_rq(rq);
> >   }
> >
> >   struct nvme_tcp_ofld_dev *
> > @@ -686,6 +689,34 @@ static void nvme_tcp_ofld_free_ctrl(struct nvme_ctrl *nctrl)
> >       kfree(ctrl);
> >   }
> >
> > +static void nvme_tcp_ofld_set_sg_null(struct nvme_command *c)
> > +{
> > +     struct nvme_sgl_desc *sg = &c->common.dptr.sgl;
> > +
> > +     sg->addr = 0;
> > +     sg->length = 0;
> > +     sg->type = (NVME_TRANSPORT_SGL_DATA_DESC << 4) | NVME_SGL_FMT_TRANSPORT_A;
> > +}
> > +
> > +inline void nvme_tcp_ofld_set_sg_inline(struct nvme_tcp_ofld_queue *queue,
> > +                                     struct nvme_command *c, u32 data_len)
> > +{
> > +     struct nvme_sgl_desc *sg = &c->common.dptr.sgl;
> > +
> > +     sg->addr = cpu_to_le64(queue->ctrl->nctrl.icdoff);
> > +     sg->length = cpu_to_le32(data_len);
> > +     sg->type = (NVME_SGL_FMT_DATA_DESC << 4) | NVME_SGL_FMT_OFFSET;
> > +}
> > +
> > +void nvme_tcp_ofld_map_data(struct nvme_command *c, u32 data_len)
> > +{
> > +     struct nvme_sgl_desc *sg = &c->common.dptr.sgl;
> > +
> > +     sg->addr = 0;
> > +     sg->length = cpu_to_le32(data_len);
> > +     sg->type = (NVME_TRANSPORT_SGL_DATA_DESC << 4) | NVME_SGL_FMT_TRANSPORT_A;
> > +}
> > +
> >   static void nvme_tcp_ofld_submit_async_event(struct nvme_ctrl *arg)
> >   {
> >       /* Placeholder - submit_async_event */
> > @@ -841,9 +872,11 @@ nvme_tcp_ofld_init_request(struct blk_mq_tag_set *set,
> >   {
> >       struct nvme_tcp_ofld_req *req = blk_mq_rq_to_pdu(rq);
> >       struct nvme_tcp_ofld_ctrl *ctrl = set->driver_data;
> > +     int qid;
> >
> > -     /* Placeholder - init request */
> > -
> > +     qid = (set == &ctrl->tag_set) ? hctx_idx + 1 : 0;
> > +     req->queue = &ctrl->queues[qid];
> > +     nvme_req(rq)->ctrl = &ctrl->nctrl;
> >       req->done = nvme_tcp_ofld_req_done;
> >       ctrl->dev->ops->init_req(req);
> >
> > @@ -858,16 +891,60 @@ EXPORT_SYMBOL_GPL(nvme_tcp_ofld_inline_data_size);
> >
> >   static void nvme_tcp_ofld_commit_rqs(struct blk_mq_hw_ctx *hctx)
> >   {
> > -     /* Call ops->commit_rqs */
> > +     struct nvme_tcp_ofld_queue *queue = hctx->driver_data;
> > +     struct nvme_tcp_ofld_dev *dev = queue->dev;
> > +     struct nvme_tcp_ofld_ops *ops = dev->ops;
> > +
> > +     ops->commit_rqs(queue);
> >   }
> >
> >   static blk_status_t
> >   nvme_tcp_ofld_queue_rq(struct blk_mq_hw_ctx *hctx,
> >                      const struct blk_mq_queue_data *bd)
> >   {
> > -     /* Call nvme_setup_cmd(...) */
> > +     struct nvme_tcp_ofld_req *req = blk_mq_rq_to_pdu(bd->rq);
> > +     struct nvme_tcp_ofld_queue *queue = hctx->driver_data;
> > +     struct nvme_tcp_ofld_ctrl *ctrl = queue->ctrl;
> > +     struct nvme_ns *ns = hctx->queue->queuedata;
> > +     struct nvme_tcp_ofld_dev *dev = queue->dev;
> > +     struct nvme_tcp_ofld_ops *ops = dev->ops;
> > +     struct nvme_command *nvme_cmd;
> > +     struct request *rq;
> > +     bool queue_ready;
> > +     u32 data_len;
> > +     int rc;
> > +
> > +     queue_ready = test_bit(NVME_TCP_OFLD_Q_LIVE, &queue->flags);
> > +
> > +     req->rq = bd->rq;
> > +     req->async = false;
> > +     rq = req->rq;
> > +
> > +     if (!nvmf_check_ready(&ctrl->nctrl, req->rq, queue_ready))
> > +             return nvmf_fail_nonready_command(&ctrl->nctrl, req->rq);
> > +
> > +     rc = nvme_setup_cmd(ns, req->rq, &req->nvme_cmd);
> > +     if (unlikely(rc))
> > +             return rc;
> >
> > -     /* Call ops->send_req(...) */
> > +     blk_mq_start_request(req->rq);
> > +     req->last = bd->last;
> > +
> > +     nvme_cmd = &req->nvme_cmd;
> > +     nvme_cmd->common.flags |= NVME_CMD_SGL_METABUF;
> > +
> > +     data_len = blk_rq_nr_phys_segments(rq) ? blk_rq_payload_bytes(rq) : 0;
> > +     if (!data_len)
> > +             nvme_tcp_ofld_set_sg_null(&req->nvme_cmd);
> > +     else if ((rq_data_dir(rq) == WRITE) &&
> > +              data_len <= nvme_tcp_ofld_inline_data_size(queue))
> > +             nvme_tcp_ofld_set_sg_inline(queue, nvme_cmd, data_len);
> > +     else
> > +             nvme_tcp_ofld_map_data(nvme_cmd, data_len);
> > +
> > +     rc = ops->send_req(req);
> > +     if (unlikely(rc))
> > +             return rc;
> >
> >       return BLK_STS_OK;
> >   }
> > @@ -940,9 +1017,11 @@ static int nvme_tcp_ofld_map_queues(struct blk_mq_tag_set *set)
> >
> >   static int nvme_tcp_ofld_poll(struct blk_mq_hw_ctx *hctx)
> >   {
> > -     /* Placeholder - Implement polling mechanism */
> > +     struct nvme_tcp_ofld_queue *queue = hctx->driver_data;
> > +     struct nvme_tcp_ofld_dev *dev = queue->dev;
> > +     struct nvme_tcp_ofld_ops *ops = dev->ops;
> >
> > -     return 0;
> > +     return ops->poll_queue(queue);
> >   }
> >
> >   static struct blk_mq_ops nvme_tcp_ofld_mq_ops = {
> >
> Reviewed-by: Hannes Reinecke <hare at suse.de>
>

Thanks.

> Cheers,
>
> Hannes
> --
> Dr. Hannes Reinecke                Kernel Storage Architect
> hare at suse.de                              +49 911 74053 688
> SUSE Software Solutions GmbH, Maxfeldstr. 5, 90409 Nürnberg
> HRB 36809 (AG Nürnberg), Geschäftsführer: Felix Imendörffer



More information about the Linux-nvme mailing list