efadv_query_cq(3)

efadv_query_cq3

Query efa specific completion queue attributes

Usage

#include <infiniband/efadv.h>
int efadv_query_cq(struct ibv_cq *ibvcq, struct efadv_cq_attr *attr,
                   uint32_t inlen);

Overview

efadv_query_cq() queries device-specific Completion Queue attributes.

Compatibility is handled using the comp_mask and inlen fields.

struct efadv_cq_attr {
    uint64_t comp_mask;
    uint8_t *buffer;
    uint32_t entry_size;
    uint32_t num_entries;
    uint32_t *doorbell;
};
inlen

In: Size of struct efadv_cq_attr.

comp_mask

Compatibility mask.

buffer

Completion queue buffer.

entry_size

Size of each completion queue entry.

num_entries

Maximal number of entries in the completion queue.

doorbell

Reverse doorbell used to update the device of polled entries and to request notifications. NULL when not in use for this Completion Queue.

Return value

efadv_query_cq() returns 0 on success, or the value of errno on failure (which indicates the failure reason).

Notes

•

Compatibility mask (comp_mask) is an out field and currently has no values.

Authors

Michael Margolin ⟨[email protected]⟩\c

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