1EFADV_QUERY_DEVICE(3)       EFA Direct Verbs Manual      EFADV_QUERY_DEVICE(3)
2
3
4

NAME

6       efadv_query_device - Query device capabilities
7

SYNOPSIS

9              #include <infiniband/efadv.h>
10
11              int efadv_query_device(struct ibv_context *ibvctx,
12                             struct efadv_device_attr *attr,
13                             uint32_t inlen);
14

DESCRIPTION

16       efadv_query_device() Queries EFA device specific attributes.
17
18       Compatibility is handled using the comp_mask and inlen fields.
19
20              struct efadv_device_attr {
21                  uint64_t comp_mask;
22                  uint32_t max_sq_wr;
23                  uint32_t max_rq_wr;
24                  uint16_t max_sq_sge;
25                  uint16_t max_rq_sge;
26                  uint16_t inline_buf_size;
27                  uint8_t reserved[2];
28                  uint32_t device_caps;
29                  uint32_t max_rdma_size;
30              };
31
32       inlen  In: Size of struct efadv_device_attr.
33
34       comp_mask
35              Compatibility mask.
36
37       max_sq_wr
38              Maximum Send Queue (SQ) Work Requests (WRs).
39
40       max_rq_wr
41              Maximum Receive Queue (RQ) Work Requests (WRs).
42
43       max_sq_sge
44              Maximum Send Queue (SQ) Scatter Gather Elements (SGEs).
45
46       max_rq_sge
47              Maximum Receive Queue (RQ) Scatter Gather Elements (SGEs).
48
49       inline_buf_size
50              Maximum inline buffer size.
51
52       device_caps
53              Bitmask of device capabilities:
54
55              EFADV_DEVICE_ATTR_CAPS_RDMA_READ: RDMA read is supported.
56
57              EFADV_DEVICE_ATTR_CAPS_RNR_RETRY: RNR retry is supported for SRD
58              QPs.
59
60              EFADV_DEVICE_ATTR_CAPS_CQ_WITH_SGID:  Reading   source   address
61              (SGID)  from receive completion descriptors is supported.  Valid
62              only for unknown AH.
63
64       max_rdma_size
65              Maximum RDMA transfer size in bytes.
66

RETURN VALUE

68       efadv_query_device() returns 0 on success, or the  value  of  errno  on
69       failure (which indicates the failure reason).
70

SEE ALSO

72       efadv(7)
73

NOTES

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

AUTHORS

79       Gal Pressman <galpress@amazon.com>
80
81
82
83efa                               2019-04-22             EFADV_QUERY_DEVICE(3)