| --- |
| 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_QUERY_ECE |
| --- |
| |
| # NAME |
| |
| ibv_query_ece - query ECE options. |
| |
| # SYNOPSIS |
| |
| ```c |
| #include <infiniband/verbs.h> |
| |
| int ibv_query_ece(struct ibv_qp *qp, struct ibv_ece *ece); |
| ``` |
| |
| # DESCRIPTION |
| |
| **ibv_query_ece()** query ECE options. |
| |
| Return to the user current ECE state for the QP. |
| |
| # ARGUMENTS |
| *qp* |
| : The queue pair (QP) associated with the ECE options. |
| |
| ## *ece* Argument |
| : The ECE values. |
| |
| ```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. |
| |
| *comp_mask* |
| : Bitmask specifying what fields in the structure are valid. |
| |
| # RETURN VALUE |
| |
| **ibv_query_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_set_ece**(3), |
| |
| # AUTHOR |
| |
| Leon Romanovsky <leonro@mellanox.com> |
| |