---
name: "rdma_disconnect"
section: "3"
platform: "linux"
package: "rdma-core"
version: "65.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/rdma_disconnect"
---

# rdma\_disconnect(3)

This function disconnects a connection.

## NAME

rdma\_disconnect - This function disconnects a connection.

## SYNOPSIS

**#include \<rdma/rdma\_cma.h\>**

**int rdma\_disconnect** **(struct rdma\_cm\_id \****id***);**

## ARGUMENTS

- id

  RDMA identifier.

## DESCRIPTION

Disconnects a connection and transitions any associated QP to the error state, which will flush any posted work requests to the completion queue.  This routine should be called by both the client and server side of a connection. After successfully disconnecting, an RDMA\_CM\_EVENT\_DISCONNECTED event will be generated on both sides of the connection.

## RETURN VALUE

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

## SEE ALSO

[rdma\_connect(3)](/rdma_connect/3.md), [rdma\_listen(3)](/rdma_listen/3.md), [rdma\_accept(3)](/rdma_accept/3.md), [rdma\_get\_cm\_event(3)](/rdma_get_cm_event/3.md)