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       max_rdma_size
61              Maximum RDMA transfer size in bytes.
62

RETURN VALUE

64       efadv_query_device() returns 0 on success, or the  value  of  errno  on
65       failure (which indicates the failure reason).
66

SEE ALSO

68       efadv(7)
69

NOTES

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

AUTHORS

75       Gal Pressman <galpress@amazon.com>
76
77
78
79efa                               2019-04-22             EFADV_QUERY_DEVICE(3)