man7.org > Linux > man-pages

Linux/UNIX system programming training

rdma_get_remote_ece(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | RETURN VALUE | SEE ALSO | AUTHOR | COLOPHON 

RDMA_GE...MOTE_ECE(3) Librdmacm Programmer’s Manual RDMA_GE...MOTE_ECE(3)

NAME         top

       rdma_get_remote_ece - Get remote ECE paraemters as received from
       the peer.

SYNOPSIS         top

              #include <rdma/rdma_cma.h>

              int rdma_get_remote_ece(struct rdma_cm_id *id, struct ibv_ece *ece);

DESCRIPTION         top

       rdma_get_remote_ece() get ECE parameters as were received from the
       communication peer.

       This function is suppose to be used by the users of external QPs.
       The call needs to be performed before replying to the peer and
       needed to allow for the passive side to know ECE options of other
       side.

       Being used by external QP and RDMA_CM doesn’t manage that QP, the
       peer needs to call to libibverbs API by itself.

       Usual flow for the passive side will be:

       • ibv_create_qp() <- create data QP.

       • ece = rdma_get_remote_ece() <- get ECE options from remote peer

       • ibv_set_ece(ece) <- set local ECE options with data received
         from the peer.

       • ibv_modify_qp() <- enable data QP.

       • rdma_set_local_ece(ece) <- set desired ECE options after
         respective libibverbs provider masked unsupported options.

       • rdma_accept()/rdma_establish()/rdma_reject_ece()

ARGUMENTS         top

       *id    RDMA communication identifier.

       *ece   ECE struct to be filled.

RETURN VALUE         top

       rdma_get_remote_ece() returns 0 on success, or -1 on error.  If an
       error occurs, errno will be set to indicate the failure reason.

SEE ALSO         top

       rdma_cm(7), rdma_set_local_ece(3)

AUTHOR         top

       Leon Romanovsky ⟨leonro@mellanox.com⟩

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

librdmacm                       2020-02-02          RDMA_GE...MOTE_ECE(3)

Pages that refer to this page: rdma_cm(7)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI