ibv_open_qp(3) — Linux manual page


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

NAME         top

       ibv_open_qp - open a shareable queue pair (QP)

SYNOPSIS         top

       #include <infiniband/verbs.h>

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

DESCRIPTION         top

       ibv_open_qp() opens an existing queue pair (QP) associated with the
       extended 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         top

       ibv_open_qp() returns a pointer to the opened QP, or NULL if the
       request fails.  Check the QP number (qp_num) in the returned QP.

NOTES         top

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

SEE ALSO         top

       ibv_alloc_pd(3), ibv_create_qp(3), ibv_create_qp_ex(3),
       ibv_modify_qp(3), ibv_query_qp(3)

AUTHORS         top

       Sean Hefty <sean.hefty@intel.com>

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 
       ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug report
       for this manual page, send it to linux-rdma@vger.kernel.org.  This
       page was obtained from the project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2020-06-09.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2020-06-05.)  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 man-pages@man7.org

libibverbs                       2011-08-12                   IBV_OPEN_QP(3)