efadv_query_cq - Man Page

Query EFA specific Completion Queue attributes

Synopsis

#include <infiniband/efadv.h>

int efadv_query_cq(struct ibv_cq *ibvcq, struct efadv_cq_attr *attr,
                   uint32_t inlen);

Description

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).

See Also

efadv(7)

Notes

Authors

Michael Margolin mrgolin@amazon.com\c

Info

2025-04-15 EFA Direct Verbs Manual