EFADV_QUERY_CQ(3)

NAME
efadv_query_cq - 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

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

AUTHORS
Michael Margolin mrgolin@amazon.com