File: ibv_set_ece.3.md

package info (click to toggle)
rdma-core 33.2-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 13,844 kB
  • sloc: ansic: 145,804; python: 5,688; sh: 2,761; perl: 1,465; makefile: 73
file content (78 lines) | stat: -rw-r--r-- 1,638 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
---
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>