.\" Automatically generated by Pandoc 3.8.2.1
.\"
.TH "EFADV_QUERY_CQ" "3" "2025\-04\-15" "efa" "EFA Direct Verbs Manual"
.SH NAME
efadv_query_cq \- Query EFA specific Completion Queue attributes
.SH SYNOPSIS
.IP
.EX
#include \f[B]<infiniband/efadv.h>\f[R]

int efadv_query_cq(\f[B]struct\f[R] ibv_cq *ibvcq, \f[B]struct\f[R] efadv_cq_attr *attr,
                   uint32_t inlen);
.EE
.SH DESCRIPTION
\f[B]efadv_query_cq()\f[R] queries device\-specific Completion Queue
attributes.
.PP
Compatibility is handled using the comp_mask and inlen fields.
.IP
.EX
\f[B]struct\f[R] efadv_cq_attr {
    uint64_t comp_mask;
    uint8_t *buffer;
    uint32_t entry_size;
    uint32_t num_entries;
    uint32_t *doorbell;
};
.EE
.TP
\f[I]inlen\f[R]
In: Size of struct efadv_cq_attr.
.TP
\f[I]comp_mask\f[R]
Compatibility mask.
.TP
\f[I]buffer\f[R]
Completion queue buffer.
.TP
\f[I]entry_size\f[R]
Size of each completion queue entry.
.TP
\f[I]num_entries\f[R]
Maximal number of entries in the completion queue.
.TP
\f[I]doorbell\f[R]
Reverse doorbell used to update the device of polled entries and to
request notifications.
NULL when not in use for this Completion Queue.
.SH RETURN VALUE
\f[B]efadv_query_cq()\f[R] returns 0 on success, or the value of errno
on failure (which indicates the failure reason).
.SH SEE ALSO
\f[B]efadv\f[R](7)
.SH NOTES
.IP \(bu 2
Compatibility mask (comp_mask) is an out field and currently has no
values.
.SH AUTHORS
Michael Margolin \c
.MT mrgolin@amazon.com
.ME \c
