.\" Automatically generated by Pandoc 3.1.11.1
.\"
.TH "HNSDV_CREATE_QP" "3" "2024\-02\-06" "hns" "HNS Programmer\[cq]s Manual"
.SH NAME
hnsdv_create_qp \- creates a HNS specific queue pair (QP)
.SH SYNOPSIS
.IP
.EX
#include <infiniband/hnsdv.h>

struct ibv_qp *hnsdv_create_qp(struct ibv_context *context,
                               struct ibv_qp_init_attr_ex *qp_attr,
                               struct hnsdv_qp_init_attr *hns_attr);
.EE
.SH DESCRIPTION
\f[B]hnsdv_create_qp()\f[R] creates a HNS specific queue pair (QP) with
specific driver properties.
.SH ARGUMENTS
Please see \f[I]ibv_create_qp_ex(3)\f[R] man page for \f[I]context\f[R]
and \f[I]qp_attr\f[R].
.SS hns_attr
.IP
.EX
struct hnsdv_qp_init_attr {
        uint64_t comp_mask;
        uint32_t create_flags;
        uint8_t congest_type;
        uint8_t reserved[3];
};
.EE
.TP
\f[I]comp_mask\f[R]
Bitmask specifying what fields in the structure are valid:
.IP
.EX
HNSDV_QP_INIT_ATTR_MASK_QP_CONGEST_TYPE:
    Valid values in congest_type. Allow setting a congestion control algorithm for QP.
.EE
.TP
\f[I]create_flags\f[R]
Enable the QP of a feature.
.TP
\f[I]congest_type\f[R]
Type of congestion control algorithm:
.RS
.PP
HNSDV_QP_CREATE_ENABLE_DCQCN: Data Center Quantized Congestion
Notification HNSDV_QP_CREATE_ENABLE_LDCP: Low Delay Control Protocol
HNSDV_QP_CREATE_ENABLE_HC3: Huawei Converged Congestion Control
HNSDV_QP_CREATE_ENABLE_DIP: Destination IP based Quantized Congestion
Notification
.RE
.SH RETURN VALUE
\f[B]hnsdv_create_qp()\f[R] returns a pointer to the created QP, on
error NULL will be returned and errno will be set.
.SH SEE ALSO
\f[B]ibv_create_qp_ex\f[R](3)
.SH AUTHOR
Junxian Huang \c
.MT huangjunxian6@hisilicon.com
.ME \c
