Skip to content

bnxt_re/lib: Support direct verbs#1654

Open
sbasavapatna wants to merge 7 commits into
linux-rdma:masterfrom
sbasavapatna:dv-upstream
Open

bnxt_re/lib: Support direct verbs#1654
sbasavapatna wants to merge 7 commits into
linux-rdma:masterfrom
sbasavapatna:dv-upstream

Conversation

@sbasavapatna

@sbasavapatna sbasavapatna commented Nov 3, 2025

Copy link
Copy Markdown

Hi,

This patchset supports Direct Verbs in the bnxt_re library.

This is required by vendor specific applications that need to manage
the HW resources directly and to implement the datapath in the
application.

To support this, the library and the driver are being enhanced to
provide Direct Verbs using which the application can allocate and
manage the HW resources (Queues, Doorbell etc) . The Direct Verbs
enable the application to implement the control path.

Patch#1 Add a helper for VA-backed buffer descriptors
Patch#2 Export HSI file
Patch#3 Support DBR and UMEM verbs
Patch#4 Support CQ verbs
Patch#5 Support QP verbs
Patch#6 Add man pages
Patch#7 Add QP man pages

Thanks,
-Harsha

@jgunthorpe

Copy link
Copy Markdown
Member

Please take the debug_file stuff out of here, I'm not keen on every driver implementing their own stuff. We already have tracing frameworks supported, why not use one?

Comment thread providers/bnxt_re/bnxt_re_dv.h Outdated
struct bnxt_re_dv_db_region_attr *attr);
int bnxt_re_dv_get_default_db_region(struct ibv_context *ibvctx,
struct bnxt_re_dv_db_region_attr *out);
void *bnxt_re_dv_umem_reg(struct ibv_context *ibvctx,

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

void *? That shouldn't be. Why do you have these functions when there is no kernel side?

@sbasavapatna

sbasavapatna commented Dec 24, 2025 via email

Copy link
Copy Markdown
Author

@sbasavapatna

sbasavapatna commented Dec 24, 2025 via email

Copy link
Copy Markdown
Author

@jgunthorpe

Copy link
Copy Markdown
Member

So give it an opaque type, don't just randomly use void *s.

Again,why is this stuff here when there is no kernel side for umems?

@sbasavapatna

sbasavapatna commented Jan 8, 2026 via email

Copy link
Copy Markdown
Author

@sbasavapatna

Copy link
Copy Markdown
Author

On Thu, Jan 8, 2026 at 1:28 AM Jason Gunthorpe @.> wrote: jgunthorpe left a comment (linux-rdma/rdma-core#1654) <#1654 (comment)> So give it an opaque type, don't just randomly use void s.
Are you suggesting to use a pointer to the forward declaration of that structure? Is that what you meant by "give it an opaque type"? Please clarify.
Again,why is this stuff here when there is no kernel side for umems?
The application registers the addr and the total size of the memory area with the library, initially using this API. Later during each object creation, the library uses this information to provide the actual va (base-addr + offset) for mapping/pinning, to the kernel driver. This has been captured in the kernel driver review thread: @.
/

— Reply to this email directly, view it on GitHub <#1654 (comment)>, or unsubscribe https://github.com/notifications/unsubscribe-auth/AGTY2BIR6EFHFZXC2CENTI34FVQP5AVCNFSM6AAAAACK7AEXQ2VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTOMRQGUZTOMBUGI . You are receiving this because you authored the thread.Message ID: @.
**>

Here's the pointer to the kernel review thread for reference:
https://lore.kernel.org/linux-rdma/CAHHeUGXGTfsK66DOGdE6Y5VYVaOR=1YA6b2inds6_EkPSwTBuA@mail.gmail.com/

@jgunthorpe

Copy link
Copy Markdown
Member

Just have some 'struct bnxt_umem' as a forward declaration that never sees an actual definition. It is now an opaque type you can use instead of void.

You also need to write man pages for these functions, see providers/mlx5/man/mlx5dv_devx_umem_reg.3.md for instance.

@sbasavapatna

sbasavapatna commented Jan 13, 2026 via email

Copy link
Copy Markdown
Author

@sbasavapatna

Copy link
Copy Markdown
Author

While looking into changes needed in the bnxt_re kernel driver to process DBR passed through driver specific attributes (during QP creation), I noticed that the corresponding libibverbs support seems to be missing in cmd_qp.c.
That is, ibv_cmd_create_qp_ex() doesn't support "ibv_command_buffer *driver" arg that should be linked to the main command buffer that it creates. This is supported in CQ creation command though (ibv_cmd_create_cq_ex2()).

@jgunthorpe

Copy link
Copy Markdown
Member

As the first user you'd need to do a similar thing as CQ.

@sbasavapatna

sbasavapatna commented Jan 17, 2026 via email

Copy link
Copy Markdown
Author

@sbasavapatna
sbasavapatna force-pushed the dv-upstream branch 2 times, most recently from 294a076 to 3d8c351 Compare February 3, 2026 05:11
@sbasavapatna
sbasavapatna force-pushed the dv-upstream branch 2 times, most recently from d43117e to 362804c Compare February 11, 2026 12:59
@sbasavapatna sbasavapatna reopened this Apr 7, 2026
@sbasavapatna
sbasavapatna force-pushed the dv-upstream branch 3 times, most recently from 7a10dd5 to 24a1e0f Compare April 8, 2026 08:33
@sbasavapatna
sbasavapatna requested a review from jgunthorpe April 8, 2026 08:34
Comment thread libibverbs/driver.h
fill_attr_in_ptr(cmdb, attr_id, storage);
cmdb->fallback_ioctl_only = 1;
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does not make sense to have this as separate helper. Your caller checks "buf->fd ==-1". You can do the check inside fill_attr_in_buf_umem and fill up things (like type) appropriately.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done, will update it in the next version.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks okay to me now.

};

struct bnxt_re_dv_umem_reg_attr {
void *addr;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This duplicates the layout of struct ibv_buf. Why you can't use it directly?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a user facing structure and we don't want to change it as it would impact applications that are already using it.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This puzzles me. How an application can use this struct if you are only introducing it now?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OOB solution which already exists is being upstreamed.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait, you say that you form the API of a feature currently being pushed upon some out of tree code and use it as argument the API can't be changed? I have troubles to understand that reasoning, sorry.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The structure layouts are slightly different. We have added a comp_mask for vendor specific extensions.

struct bnxt_re_dv_umem_reg_attr {
void *addr;
size_t size;
uint64_t comp_mask;
int dmabuf_fd;
};
struct ibv_buf {
void *addr;
size_t size;
struct ibv_pd *pd;
int dmabuf_fd;
};

Also, since this is a Direct Verb to the user application, we want to maintain the same ABI for both our inbox and out-of-tree libraries, so that the applications can work seamlessly on both installations. So unless you see a design level issue here, we would prefer to keep this as-is and avoid any impact to existing customers that are using out-of-tree packages.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why you have comp_mask here is a mystery. Not needed (and if really, really need it, you can embed ibv_buf - so no argument). Basically they are same structures. Don't screw-up the API in a name of out-of-tree code. That is fundamentally wrong. Please fix.

sbasavapatna and others added 7 commits July 16, 2026 14:41
fill_attr_in_buf_umem() only handles dmabuf-backed buffers.
Extend it for user virtual address buffers.

Signed-off-by: Sriharsha Basavapatna <sriharsha.basavapatna@broadcom.com>
Extract HSI definitions (WQE/CQE structures and enums) from
bnxt_re-abi.h into a standalone bnxt_re-hsi.h and add it to
publish_headers() so it is installed under infiniband/.

This will make HSI definitions available to DV applications,
that implement their own datapath.

Signed-off-by: Sriharsha Basavapatna <sriharsha.basavapatna@broadcom.com>
Reviewed-by: Selvin Xavier <selvin.xavier@broadcom.com>
The following Direct Verb (DV) APIs have been implemented in
this patch.

Doorbell Region Direct Verbs:

- bnxt_re_dv_alloc_db_region():
  This will allow the appliation to create extra doorbell regions
  and use the associated doorbell page index in dv_create_qp() and
  use the associated DB address while ringing the doorbell.

- bnxt_re_dv_free_db_region():
  Free the allocated doorbell region.

- bnxt_re_dv_get_default_db_region():
  Return the default doorbell page index and doorbell page address
  associated with the ucontext.

Umem Registration Direct Verbs:

- bnxt_re_dv_umem_reg():
  Register the user memory to be used by the application with
  the library. Application can register a large chunk of memory and
  use it during subsequent resource creation DV APIs.

  Note that the API terminates in the library and the app specified
  memory params (addr, len) are saved and a umem-handle is returned.
  That is, there is no ioctl to the driver at this point to map/pin
  the user memory.

  This memory is mapped/pinned later when the application creates
  the required resources (CQ/QP) using respective direct verbs.
  This is implemented in the next patch in this series.

- bnxt_re_dv_umem_dereg():
  Deregister the user memory specified by the umem-handle.

Co-developed-by: Sriharsha Basavapatna <sriharsha.basavapatna@broadcom.com>
Signed-off-by: Sriharsha Basavapatna <sriharsha.basavapatna@broadcom.com>
Signed-off-by: Kalesh AP <kalesh-anakkur.purayil@broadcom.com>
Reviewed-by: Selvin Xavier <selvin.xavier@broadcom.com>
The following Direct Verb (DV) APIs have been implemented in
this patch. These are implemented by enhancing the driver
specific udata in existing verbs.

CQ Direct Verbs:

- bnxt_re_dv_create_cq():
  Create a CQ of requested size (cqe). The application must have
  already registered this memory using bnxt_re_dv_umem_reg().
  The CQ umem-handle and umem-offset provided by the application
  are translated into an address for mapping and passed to the
  driver.

- bnxt_re_dv_destroy_cq():
  Destroy the DV_CQ created earlier.

Note:
Some applications might want to allocate memory for all CQs in one big
chunk and then register that entire memory once using dv_umem_reg().
At the time of creating each individual resource, the application
should pass a specific offset/length in the umem registered memory.

Signed-off-by: Sriharsha Basavapatna <sriharsha.basavapatna@broadcom.com>
Co-developed-by: Kalesh AP <kalesh-anakkur.purayil@broadcom.com>
Signed-off-by: Kalesh AP <kalesh-anakkur.purayil@broadcom.com>
Reviewed-by: Selvin Xavier <selvin.xavier@broadcom.com>

fix
The following Direct Verb (DV) APIs have been implemented in
this patch. These are implemented by enhancing the driver
specific udata in existing verbs.

QP Direct Verbs:
- bnxt_re_dv_create_qp():
  Create a QP using specified params (struct bnxt_re_dv_qp_init_attr).
  The application must have already registered SQ/RQ memory using
  bnxt_re_dv_umem_reg(). The SQ/RQ umem-handle and umem-offset provided
  by the application are translated into an address for mapping and
  passed to the driver.

- bnxt_re_dv_destroy_qp():
  Destroy the DV_QP created earlier.

- bnxt_re_dv_modify_qp():
  Modify QP attributes of the DV_QP.

- bnxt_re_dv_query_qp():
  Return QP attributes of the DV_QP.

Note:
Some applications might want to allocate memory for all QPs in one big
chunk and then register that entire memory once using dv_umem_reg().
At the time of creating each individual resource, the application
should pass a specific offset/length in the umem registered memory.

Signed-off-by: Sriharsha Basavapatna <sriharsha.basavapatna@broadcom.com>
Reviewed-by: Selvin Xavier <selvin.xavier@broadcom.com>
Document direct verbs (DV) feature and related DV APIs.
The man page describes these DV APIs:
- Doorbell regions (db)
- User memory (umem)
- Completion Queues (cq)

Signed-off-by: Sriharsha Basavapatna <sriharsha.basavapatna@broadcom.com>
Reviewed-by: Selvin Xavier <selvin.xavier@broadcom.com>
Document QP related DV APIs:
    bnxt_re_dv_create_qp
    bnxt_re_dv_destroy_qp
    bnxt_re_dv_modify_qp
    bnxt_re_dv_query_qp

Signed-off-by: Sriharsha Basavapatna <sriharsha.basavapatna@broadcom.com>
Reviewed-by: Selvin Xavier <selvin.xavier@broadcom.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants