rdma_migrate_id(3) — Linux manual page

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

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

NAME top

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

SYNOPSIS top

       #include <rdma/rdma_cma.h>

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

ARGUMENTS top

       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 top

       Migrates a communication identifier to a different event channel.

RETURN VALUE top

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

NOTES top

       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 top

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

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 2020-08-13.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2020-08-05.)  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)