EFADV_QUERY_CQ(3)           EFA Direct Verbs Manual          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
       o Compatibility mask (comp_mask) is an out field and currently has no
         values.

AUTHORS
       Michael Margolin <mrgolin@amazon.com>

efa                               2025-04-15                 EFADV_QUERY_CQ(3)