.\" Automatically generated by Pandoc 3.11 .\" .TH "IONIC_DV_CREATE_QP_EX" "3" "2025\-06\-23" "ionic" "Ionic Programmer\(cqs Manual" .SH NAME ionic_dv_create_qp_ex \- Create a queue pair with ionic\-specific attributes .SH SYNOPSIS .IP .EX #include \f[B]\f[R] \f[B]struct\f[R] ibv_qp *ionic_dv_create_qp_ex(\f[B]struct\f[R] ibv_context *ibctx, \f[B]struct\f[R] ibv_qp_init_attr_ex *ex, \f[B]struct\f[R] ionic_dv_qp_init_attr_ex *ionic_ex); .EE .SH DESCRIPTION \f[B]ionic_dv_create_qp_ex()\f[R] creates a queue pair (QP) with ionic\-specific driver properties. It extends the standard \f[B]ibv_create_qp_ex\f[R](3) interface with ionic\-specific attributes for configuring RCCL (RC Collective) operations and Reorder Completion Queue (RCQ) behavior. .PP The caller specifies \f[B]IBV_QPT_RC\f[R] as the QP type in the standard \f[I]ex\f[R] attributes. The returned QP always has \f[I]qp_type\f[R] == \f[B]IBV_QPT_RC\f[R]. .SH ARGUMENTS Please see \f[I]ibv_create_qp_ex(3)\f[R] man page for \f[I]ibctx\f[R] and \f[I]ex\f[R]. .SS ionic_ex .IP .EX \f[B]enum\f[R] ionic_qp_init_attr_mask { IONIC_QP_INIT_ATTR_MASK_FLAGS = 1 << 0, }; \f[B]enum\f[R] ionic_qp_init_attr_flags { IONIC_QP_INIT_ATTR_RCCL = 1 << 16, IONIC_QP_INIT_ATTR_RCCL_DATA = 1 << 17, IONIC_QP_INIT_ATTR_RCCL_RDFENCE = 1 << 18, IONIC_QP_INIT_ATTR_RCCL_RX_OFFLOAD = 1 << 19, IONIC_QP_INIT_ATTR_RCCL_RCQ = 1 << 24, }; \f[B]struct\f[R] ionic_dv_qp_init_attr_ex { uint64_t comp_mask; uint32_t flags; }; .EE .TP \f[I]comp_mask\f[R] Bitmask specifying what fields in the structure are valid. Composed of \f[B]ionic_dv_qp_init_attr_mask\f[R] values: .RS \f[B]IONIC_QP_INIT_ATTR_MASK_FLAGS\f[R]: Valid values in \f[I]flags\f[R]. .RE .TP \f[I]flags\f[R] A bitwise OR of the various values described below. Valid when \f[I]comp_mask\f[R] includes \f[B]IONIC_QP_INIT_ATTR_MASK_FLAGS\f[R]. .RS \f[B]IONIC_QP_INIT_ATTR_RCCL\f[R]: Create an RCCL (RC Collective) QP type. \f[B]IONIC_QP_INIT_ATTR_RCCL_DATA\f[R]: Enable RCCL data operations on this QP. \f[B]IONIC_QP_INIT_ATTR_RCCL_RDFENCE\f[R]: Enable RCCL read fence operations on this QP. \f[B]IONIC_QP_INIT_ATTR_RCCL_RX_OFFLOAD\f[R]: Enable RCCL receive offload operations on this QP. \f[B]IONIC_QP_INIT_ATTR_RCCL_RCQ\f[R]: Enable Reorder Completion Queue (RCQ) for this QP. When enabled, out\-of\-order receive completions are reordered so that completions are delivered to the application in order. .RE .SH RETURN VALUE \f[B]ionic_dv_create_qp_ex()\f[R] returns a pointer to the created QP, or NULL if the request fails (in which case \f[I]errno\f[R] is set to indicate the error). .SH NOTES The \f[I]ex\->qp_type\f[R] field must be \f[B]IBV_QPT_RC\f[R]. The returned QP always exposes \f[I]qp_type\f[R] == \f[B]IBV_QPT_RC\f[R] to the application. .PP Compatibility is handled through the \f[I]comp_mask\f[R] field. Applications should only set bits for fields they intend to use. Unknown bits in \f[I]comp_mask\f[R] are reserved for future extensions. .SH EXAMPLES .IP .EX \f[B]struct\f[R] ibv_qp_init_attr_ex qp_attr = { .send_cq = cq, .recv_cq = cq, .cap = { .max_send_wr = 64, .max_recv_wr = 64, .max_send_sge = 4, .max_recv_sge = 4, }, .qp_type = IBV_QPT_RC, .comp_mask = IBV_QP_INIT_ATTR_PD, .pd = pd, }; \f[B]struct\f[R] ionic_dv_qp_init_attr_ex ionic_attr = { .comp_mask = IONIC_QP_INIT_ATTR_MASK_FLAGS, .flags = IONIC_QP_INIT_ATTR_RCCL_RCQ, }; \f[B]struct\f[R] ibv_qp *qp = ionic_dv_create_qp_ex(ctx, &qp_attr, &ionic_attr); .EE .SH SEE ALSO \f[B]ionicdv\f[R](7), \f[B]ibv_create_qp_ex\f[R](3), \f[B]ionic_dv_pd_set_udma_mask\f[R](3), \f[B]ionic_dv_pd_set_sqcmb\f[R](3), \f[B]ionic_dv_pd_set_rqcmb\f[R](3) .SH AUTHORS Advanced Micro Devices, Inc.