FreeBSD manual

download PDF document: rdma_migrate_id.3.pdf

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) librdmacm 2007-11-13 RDMA_MIGRATE_ID(3)