contrib/ofed/librdmacm/man/rdma_migrate_id.3

   1 .TH "RDMA_MIGRATE_ID" 3 "2007-11-13" "librdmacm" "Librdmacm Programmer's Manual" librdmacm
   2 .SH NAME
   3 rdma_migrate_id \- Move a communication identifer to a different event channel.
   4 .SH SYNOPSIS
   5 .B "#include <rdma/rdma_cma.h>"
   6 .P
   7 .B "int" rdma_migrate_id
   8 .BI "(struct rdma_cm_id *" id ","
   9 .BI "struct rdma_event_channel *" channel ");"
  10 .SH ARGUMENTS
  11 .IP "id" 12
  12 An existing communication identifier to migrate.
  13 .IP "channel" 12
  14 The communication channel that events associated with the
  15 allocated rdma_cm_id will be reported on.
  16 .SH "DESCRIPTION"
  17 Migrates a communication identifier to a different event channel.
  18 .SH "NOTES"
  19 This routine migrates a communication identifier to the specified event
  20 channel and moves any pending events associated with the rdma_cm_id
  21 to the new channel.  Users should not poll for events on the
  22 rdma_cm_id's current event channel or invoke other routines on the
  23 rdma_cm_id while migrating between channels.  This call will block while
  24 there are any unacknowledged events on the current event channel.
  25 .SH "SEE ALSO"
  26 rdma_cm(7), rdma_create_event_channel(3), rdma_create_id(3),
  27 rdma_get_cm_event(3)