mlx5dv_open_device(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | RETURN VALUE | SEE ALSO | AUTHOR | COLOPHON

mlx5dv_open_device(3)                               mlx5dv_open_device(3)

NAME         top

       mlx5dv_open_device - Open an RDMA device context for the mlx5
       provider

SYNOPSIS         top

              #include <infiniband/mlx5dv.h>

              struct ibv_context *
              mlx5dv_open_device(struct ibv_device *device, struct mlx5dv_context_attr *attr);

DESCRIPTION         top

       Open an RDMA device context with specific mlx5 provider
       attributes.

ARGUMENTS         top

       device RDMA device to open.

       attr

   mlx5dv_context_attr
              struct mlx5dv_context_attr {
                      uint32_t flags;
                      uint64_t comp_mask;
                      struct ibv_fd_arr *fds;
              };

       flags

              A bitwise OR of the various values described below.

              *MLX5DV_CONTEXT_FLAGS_DEVX*:
              Allocate a DEVX context

       comp_mask

              Bitmask specifying what fields in the structure are valid

              *MLX5DV_CONTEXT_ATTR_MASK_FD_ARRAY*:
              Valid value in *fds*

       fds

              Used to pass a file descriptor array.

   ibv_fd_arr
              struct ibv_fd_arr {
                      int *arr;
                      uint32_t count;
              };

       arr    Pointer to the file descriptor array.

       count  Number of elements in the array.

RETURN VALUE         top

       Returns a pointer to the allocated device context, or NULL if the
       request fails.

SEE ALSO         top

       ibv_open_device(3)

AUTHOR         top

       Yishai Hadas ⟨yishaih@mellanox.com⟩

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                                    mlx5dv_open_device(3)

Pages that refer to this page: mlx5dv_create_mkey(3)mlx5dv_destroy_mkey(3)mlx5dv_mkey_check(3)mlx5dv_qp_cancel_posted_send_wrs(3)mlx5dv_wr_mkey_configure(3)mlx5dv_wr_set_mkey_access_flags(3)mlx5dv_wr_set_mkey_layout_interleaved(3)mlx5dv_wr_set_mkey_layout_list(3)mlx5dv_wr_set_mkey_sig_block(3)