rdma_migrate_id(3) — Linux manual page

RDMA_MIGRATE_ID(3)    Librdmacm Programmer's Manual   RDMA_MIGRATE_ID(3)

NAME

       rdma_migrate_id - Move a communication identifier to a different
       event channel.

SYNOPSIS

       #include <rdma/rdma_cma.h>

       int rdma_migrate_id (struct rdma_cm_id *id, struct
       rdma_event_channel *channel);

ARGUMENTS

       id          An existing communication identifier to migrate.

       channel     The communication channel that events associated with
                   the allocated rdma_cm_id will be reported on.  May be
                   NULL.

DESCRIPTION

       Migrates a communication identifier to a different event channel.

RETURN VALUE

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

NOTES

       This routine migrates a communication identifier to the specified
       event channel and moves any pending events associated with the
       rdma_cm_id to the new channel.  Users should not poll for events
       on the rdma_cm_id's current event channel or invoke other
       routines on the rdma_cm_id while migrating between channels.
       This call will block while there are any unacknowledged events on
       the current event channel.

       If the channel parameter is NULL, the specified rdma_cm_id will
       be placed into synchronous operation mode.  All calls on the id
       will block until the operation completes.

SEE ALSO

       rdma_cm(7), rdma_create_event_channel(3), rdma_create_id(3),
       rdma_get_cm_event(3)

COLOPHON

       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 2024-06-14.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2024-06-10.)  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                      2007-11-13             RDMA_MIGRATE_ID(3)

Pages that refer to this page: rdma_create_ep(3), rdma_cm(7)

---