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

Synopsis

#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

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 <infiniband/verbs.h>.

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

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

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

See Also

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

Authors

Yishai Hadas <yishaih@mellanox.com>

Referenced By

ibv_create_qp_ex(3).

The man page ibv_destroy_rwq_ind_table(3) is an alias of ibv_create_rwq_ind_table(3).

2016-07-27 Libibverbs Programmer's Manual