mlx5dv_open_device(3)                                    mlx5dv_open_device(3)

NAME
       mlx5dv_open_device - Open an RDMA device context for the mlx5 provider

SYNOPSIS
              #include <infiniband/mlx5dv.h>

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

DESCRIPTION
       Open an RDMA device context with specific mlx5 provider attributes.

ARGUMENTS
       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
       Returns a pointer to the allocated device context, or NULL if the
       request fails.

SEE ALSO
       ibv_open_device(3)

AUTHOR
       Yishai Hadas <yishaih@mellanox.com>

                                                         mlx5dv_open_device(3)