1CREATE_RWQ_IND_TBL(3)   Libibverbs Programmer's Manual   CREATE_RWQ_IND_TBL(3)
2
3
4

NAME

6       ibv_create_rwq_ind_table,   ibv_destroy_rwq_ind_table    -   create  or
7       destroy a Receive Work Queue Indirection Table (RWQ IND TBL).
8

SYNOPSIS

10       #include <infiniband/verbs.h>
11
12       struct ibv_rwq_ind_table *ibv_create_rwq_ind_table(struct ibv_context *context,
13                                                                  struct ibv_rwq_ind_table_init_attr *init_attr);
14
15       int ibv_destroy_rwq_ind_table(struct ibv_rwq_ind_table *rwq_ind_table);
16

DESCRIPTION

18       ibv_create_rwq_ind_table() creates a RWQ IND TBL  associated  with  the
19       ibv_context  context.   The  argument  init_attr  is an ibv_rwq_ind_ta‐
20       ble_init_attr struct, as defined in <infiniband/verbs.h>.
21
22       struct ibv_rwq_ind_table_init_attr {
23               uint32_t        log_ind_tbl_size;     /* Log, base 2, of Indirection table size */
24               struct          ibv_wq **ind_tbl;     /* Each entry is a pointer to Receive Work Queue */
25               uint32_t        comp_mask;            /* Identifies valid fields. Use ibv_ind_table_init_attr_mask */
26       };
27
28       The function ibv_create_rwq_ind_table() will create a RWQ IND TBL  that
29       holds  a table of Receive Work Queue.  For further usage of the created
30       object see below NOTES.
31
32       ibv_destroy_rwq_ind_table() destroys the RWQ IND TBL rwq_ind_table.
33

RETURN VALUE

35       ibv_create_rwq_ind_table() returns a pointer to  the  created  RWQ  IND
36       TBL, or NULL if the request fails.
37
38       ibv_destroy_rwq_ind_table() returns 0 on success, or the value of errno
39       on failure (which indicates the failure reason).
40

NOTES

42       The created object should be used  as  part  of  ibv_create_qp_ex()  to
43       enable dispatching of incoming packets based on some RX hash configura‐
44       tion.
45

SEE ALSO

47       ibv_create_wq(3), ibv_modify_wq(3), ibv_create_qp_ex(3),
48

AUTHORS

50       Yishai Hadas <yishaih@mellanox.com>
51
52
53
54libibverbs                        2016-07-27             CREATE_RWQ_IND_TBL(3)