CREATE_RWQ_IND_TBL(3)  Libibverbs Programmer's Manual  CREATE_RWQ_IND_TBL(3)

NAME         top

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

SYNOPSIS         top

       #include <infiniband/verbs.h>

       struct ibv_rwq_ind_table *ibv_create_rwq_ind_table(struct ibv_context *context,
                                                                  struct ibv_rwq_ind_table_init_attr *init_attr);

       int ibv_destroy_rwq_ind_table(struct ibv_rwq_ind_table *rwq_ind_table);

DESCRIPTION         top

       ibv_create_rwq_ind_table() creates a RWQ IND TBL associated with the
       ibv_context context.  The argument init_attr is an
       ibv_rwq_ind_table_init_attr struct, as defined in

       struct ibv_rwq_ind_table_init_attr {
               uint32_t        log_ind_tbl_size;     /* Log, base 2, of Indirection table size */
               struct          ibv_wq **ind_tbl;     /* Each entry is a pointer to Receive Work Queue */
               uint32_t        comp_mask;            /* Identifies valid fields. Use ibv_ind_table_init_attr_mask */

       The function ibv_create_rwq_ind_table() will create a RWQ IND TBL
       that holds a table of Receive Work Queue.  For further usage of the
       created object see below NOTES.

       ibv_destroy_rwq_ind_table() destroys the RWQ IND TBL rwq_ind_table.

RETURN VALUE         top

       ibv_create_rwq_ind_table() returns a pointer to the created RWQ IND
       TBL, or NULL if the request fails.

       ibv_destroy_rwq_ind_table() returns 0 on success, or the value of
       errno on failure (which indicates the failure reason).

NOTES         top

       The created object should be used as part of ibv_create_qp_ex() to
       enable dispatching of incoming packets based on some RX hash

SEE ALSO         top

       ibv_create_wq(3), ibv_modify_wq(3), ibv_create_qp_ex(3),

AUTHORS         top

       Yishai Hadas <>

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries and
       Daemons) project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report
       for this manual page, send it to  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2020-02-08.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2020-02-07.)  If you discover any rendering problems
       in this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to

libibverbs                       2016-07-27            CREATE_RWQ_IND_TBL(3)

Pages that refer to this page: ibv_create_qp_ex(3)