dwww Home | Manual pages | Find package

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

NAME
       ibv_open_qp - open a shareable queue pair (QP)

SYNOPSIS
       #include <infiniband/verbs.h>

       struct ibv_qp *ibv_open_qp(struct ibv_context *context,
                                  struct ibv_qp_open_attr *qp_open_attr);

DESCRIPTION
       ibv_open_qp() opens an existing queue pair (QP) associated with the ex-
       tended  protection  domain  xrcd.   The  argument  qp_open_attr  is  an
       ibv_qp_open_attr struct, as defined in <infiniband/verbs.h>.

       struct ibv_qp_open_attr {
               uint32_t          comp_mask;  /* Identifies valid fields */
               uint32_t          qp_num;     /* QP number */
               struct            *ibv_xrcd;  /* XRC domain */
               void             *qp_context; /* User defined opaque value */
               enum ibv_qp_type  qp_type;    /* QP transport service type */

       ibv_destroy_qp() closes the opened QP and destroys the underlying QP if
       it has no other references.  qp.

RETURN VALUE
       ibv_open_qp() returns a pointer to the opened QP, or NULL  if  the  re-
       quest fails.  Check the QP number (qp_num) in the returned QP.

NOTES
       ibv_open_qp() will fail if a it is asked to open a QP that does not ex-
       ist within the xrcd with the specified qp_num and qp_type.

SEE ALSO
       ibv_alloc_pd(3),   ibv_create_qp(3),   ibv_create_qp_ex(3),    ibv_mod-
       ify_qp(3), ibv_query_qp(3)

AUTHORS
       Sean Hefty <sean.hefty@intel.com>

libibverbs                        2011-08-12                    IBV_OPEN_QP(3)

Generated by dwww version 1.14 on Fri Jan 24 06:06:24 CET 2025.