.\" Automatically generated by Pandoc 2.18
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "IBV_SET_ECE" "3" "2020-01-22" "libibverbs" "Libibverbs Programmer\[cq]s Manual"
.hy
.SH NAME
.PP
ibv_set_ece - set ECE options and use them for QP configuration stage.
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <infiniband/verbs.h>

int ibv_set_ece(struct ibv_qp *qp, struct ibv_ece *ece);
\f[R]
.fi
.SH DESCRIPTION
.PP
\f[B]ibv_set_ece()\f[R] set ECE options and use them for QP
configuration stage.
.PP
The desired ECE options will be used during various modify QP stages
based on supported options in relevant QP state.
.SH ARGUMENTS
.TP
\f[I]qp\f[R]
The queue pair (QP) associated with the ECE options.
.TP
## \f[I]ece\f[R] Argument
The requested ECE values.
This is IN/OUT field, the accepted options will be returned in this
field.
.IP
.nf
\f[C]
struct ibv_ece {
    uint32_t vendor_id;
    uint32_t options;
    uint32_t comp_mask;
};
\f[R]
.fi
.TP
\f[I]vendor_id\f[R]
Unique identifier of the provider vendor on the network.
The providers will set IEEE OUI here to distinguish itself in
non-homogenius network.
.TP
\f[I]options\f[R]
Provider specific attributes which are supported or needed to be enabled
by ECE users.
.TP
\f[I]comp_mask\f[R]
Bitmask specifying what fields in the structure are valid.
.SH RETURN VALUE
.PP
\f[B]ibv_set_ece()\f[R] returns 0 when the call was successful, or the
errno value which indicates the failure reason.
.TP
\f[I]EOPNOTSUPP\f[R]
libibverbs or provider driver doesn\[cq]t support the ibv_set_ece()
verb.
.TP
\f[I]EINVAL\f[R]
In one of the following: o The QP is invalid.
o The ECE options are invalid.
.SH SEE ALSO
.PP
\f[B]ibv_query_ece\f[R](3),
.SH AUTHOR
.PP
Leon Romanovsky <leonro@mellanox.com>
