carta
mlx5dv_create_cq(3)

mlx5dv_create_cq3

Creates a completion queue (cq)

Overview

mlx5dv_create_cq() creates a completion queue (CQ) with specific driver properties.

Arguments

Please see ibv_create_cq_ex(3) man page for context and cq_attr

mlx5_cq_attr

struct mlx5dv_cq_init_attr {
    uint64_t comp_mask;
    uint8_t  cqe_comp_res_format;
    uint32_t flags;
    uint16_t cqe_size;
};
comp_mask

Bitmask specifying what fields in the structure are valid:

MLX5DV_CQ_INIT_ATTR_MASK_COMPRESSED_CQE enables creating a CQ in a mode that few CQEs may be compressed into a single CQE, valid values in cqe_comp_res_format MLX5DV_CQ_INIT_ATTR_MASK_FLAGS valid values in flags MLX5DV_CQ_INIT_ATTR_MASK_CQE_SIZE valid values in cqe_size

cqe_comp_res_format

A bitwise OR of the various CQE response formats of the responder side:

MLX5DV_CQE_RES_FORMAT_HASH CQE compression with hash MLX5DV_CQE_RES_FORMAT_CSUM CQE compression with RX checksum MLX5DV_CQE_RES_FORMAT_CSUM_STRIDX CQE compression with stride index

flags

A bitwise OR of the various values described below:

MLX5DV_CQ_INIT_ATTR_FLAGS_CQE_PAD create a padded 128B CQE

cqe_size

configure the CQE size to be 64 or 128 bytes other values will fail mlx5dv_create_cq.

Return value

mlx5dv_create_cq() returns a pointer to the created CQ, or NULL if the request fails and errno will be set.

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)

Author

Yonatan Cohen ⟨[email protected]⟩\c

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