mlx5dv_open_device(3)

mlx5dv_open_device3

Open an rdma device context for the mlx5 provider

Usage

#include <infiniband/mlx5dv.h>
struct ibv_context *
mlx5dv_open_device(struct ibv_device *device, struct mlx5dv_context_attr *attr);

Overview

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.

Releases

5 releases since Debian 10 (Buster); the text changed 4 times.

  1. 10
  2. 11
  3. 12
  4. 13
  5. Arch

Author

Yishai Hadas ⟨[email protected]⟩\c

From rdma-core 65.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.