xref: /freebsd/contrib/ofed/librdmacm/man/rdma_migrate_id.3 (revision 0b3105a37d7adcadcb720112fed4dc4e8040be99)
"RDMA_MIGRATE_ID" 3 "2007-11-13" "librdmacm" "Librdmacm Programmer's Manual" librdmacm
NAME
rdma_migrate_id - Move a communication identifer 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" 12
An existing communication identifier to migrate.
"channel" 12
The communication channel that events associated with the allocated rdma_cm_id will be reported on.
"DESCRIPTION"
Migrates a communication identifier to a different event channel.
"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.
"SEE ALSO"
rdma_cm(7), rdma_create_event_channel(3), rdma_create_id(3), rdma_get_cm_event(3)