libibverbs/man/ibv_set_ece.3.md

---
date: 2020-01-22
footer: libibverbs
header: "Libibverbs Programmer's Manual"
layout: page
license: 'Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md'
section: 3
title: IBV_SET_ECE
---

# NAME

ibv_set_ece - set ECE options and use them for QP configuration stage.

# SYNOPSIS

```c
#include <infiniband/verbs.h>

int ibv_set_ece(struct ibv_qp *qp, struct ibv_ece *ece);
```

# DESCRIPTION

**ibv_set_ece()** set ECE options and use them for QP configuration stage.

The desired ECE options will be used during various modify QP stages
based on supported options in relevant QP state.

# ARGUMENTS
*qp*
:	The queue pair (QP) associated with the ECE options.

## *ece* Argument
:	The requested ECE values. This is IN/OUT field, the accepted options
        will be returned in this field.

```c
struct ibv_ece {
	uint32_t vendor_id;
	uint32_t options;
	uint32_t comp_mask;
};
```

*vendor_id*
:	Unique identifier of the provider vendor on the network.
	The providers will set IEEE OUI here to distinguish itself
	in non-homogenius network.

*options*
:	Provider specific attributes which are supported or
	needed to be enabled by ECE users.

*comp_mask*
:	Bitmask specifying what fields in the structure are valid.

# RETURN VALUE

**ibv_set_ece()** returns 0 when the call was successful, or the errno value
	which indicates the failure reason.

*EOPNOTSUPP*
:	libibverbs or provider driver doesn't support the ibv_set_ece() verb.

*EINVAL*
:	In one of the following:
	o The QP is invalid.
	o The ECE options are invalid.

# SEE ALSO

**ibv_query_ece**(3),

# AUTHOR

Leon Romanovsky <leonro@mellanox.com>