rdma_migrate_id(3)

rdma_migrate_id3

Move a communication identifier to a different event channel.

Usage

#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.

Overview

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.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 3 times.

  1. 5.0–6.0
  2. 7–8
  3. 9
  4. 10–Arch

From rdma-core 65.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.