ibv_create_srq_ex(3) [centos man page]
IBV_CREATE_SRQ_EX(3) Libibverbs Programmer's Manual IBV_CREATE_SRQ_EX(3) NAME
ibv_create_srq_ex, ibv_destroy_srq - create or destroy a shared receive queue (SRQ) SYNOPSIS
#include <infiniband/verbs.h> struct ibv_srq *ibv_create_srq_ex(struct ibv_context *context, struct ibv_srq_init_attr_ex *srq_init_attr_ex); int ibv_destroy_srq(struct ibv_srq *srq); DESCRIPTION
ibv_create_srq_ex() creates a shared receive queue (SRQ) supporting both basic and xrc modes. The argument srq_init_attr_ex is an ibv_srq_init_attr_ex struct, as defined in <infiniband/verbs.h>. struct ibv_srq_init_attr_ex { void *srq_context; /* Associated context of the SRQ */ struct ibv_srq_attr attr; /* SRQ attributes */ uint32_t comp_mask; /* Identifies valid fields */ enum ibv_srq_type srq_type; /* Basic / XRC */ struct ibv_pd *pd; /* PD associated with the SRQ */ struct ibv_xrcd *xrcd; /* XRC domain to associate with the SRQ */ struct ibv_cq *cq; /* CQ to associate with the SRQ for XRC mode */ }; struct ibv_srq_attr { uint32_t max_wr; /* Requested max number of outstanding work requests (WRs) in the SRQ */ uint32_t max_sge; /* Requested max number of scatter elements per WR */ uint32_t srq_limit; /* The limit value of the SRQ */ }; The function ibv_create_srq_ex() will update the srq_init_attr_ex struct with the original values of the SRQ that was created; the values of max_wr and max_sge will be greater than or equal to the values requested. ibv_destroy_srq() destroys the SRQ srq. RETURN VALUE
ibv_create_srq_ex() returns a pointer to the created SRQ, or NULL if the request fails. ibv_destroy_srq() returns 0 on success, or the value of errno on failure (which indicates the failure reason). NOTES
ibv_destroy_srq() fails if any queue pair is still associated with this SRQ. SEE ALSO
ibv_alloc_pd(3), ibv_modify_srq(3), ibv_query_srq(3) AUTHORS
Yishai Hadas <yishaih@mellanox.com> libibverbs 2013-06-26 IBV_CREATE_SRQ_EX(3)
Check Out this Related Man Page
IBV_POST_SRQ_RECV(3) Libibverbs Programmer's Manual IBV_POST_SRQ_RECV(3) NAME
ibv_post_srq_recv - post a list of work requests (WRs) to a shared receive queue (SRQ) SYNOPSIS
#include <infiniband/verbs.h> int ibv_post_srq_recv(struct ibv_srq *srq, struct ibv_recv_wr *wr, struct ibv_recv_wr **bad_wr); DESCRIPTION
ibv_post_srq_recv() posts the linked list of work requests (WRs) starting with wr to the shared receive queue (SRQ) srq. It stops process- ing WRs from this list at the first failure (that can be detected immediately while requests are being posted), and returns this failing WR through bad_wr. The argument wr is an ibv_recv_wr struct, as defined in <infiniband/verbs.h>. struct ibv_recv_wr { uint64_t wr_id; /* User defined WR ID */ struct ibv_recv_wr *next; /* Pointer to next WR in list, NULL if last WR */ struct ibv_sge *sg_list; /* Pointer to the s/g array */ int num_sge; /* Size of the s/g array */ }; struct ibv_sge { uint64_t addr; /* Start address of the local memory buffer */ uint32_t length; /* Length of the buffer */ uint32_t lkey; /* Key of the local Memory Region */ }; RETURN VALUE
ibv_post_srq_recv() returns 0 on success, or the value of errno on failure (which indicates the failure reason). NOTES
The buffers used by a WR can only be safely reused after WR the request is fully executed and a work completion has been retrieved from the corresponding completion queue (CQ). If a WR is being posted to a UD QP, the Global Routing Header (GRH) of the incoming message will be placed in the first 40 bytes of the buffer(s) in the scatter list. If no GRH is present in the incoming message, then the first bytes will be undefined. This means that in all cases, the actual data of the incoming message will start at an offset of 40 bytes into the buffer(s) in the scatter list. SEE ALSO
ibv_create_qp(3), ibv_post_send(3), ibv_post_recv(3), ibv_poll_cq(3) AUTHORS
Dotan Barak <dotanba@gmail.com> libibverbs 2006-10-31 IBV_POST_SRQ_RECV(3)