---
name: "rdma_leave_multicast"
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_leave_multicast"
---

# rdma\_leave\_multicast(3)

Leaves a multicast group.

## NAME

rdma\_leave\_multicast - Leaves a multicast group.

## SYNOPSIS

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

**int rdma\_leave\_multicast** **(struct rdma\_cm\_id \****id***,** **struct sockaddr \****addr***);**

## ARGUMENTS

- id

  Communication identifier associated with the request.

- addr

  Multicast address identifying the group to leave.

## DESCRIPTION

Leaves a multicast group and detaches an associated QP from the group.

## RETURN VALUE

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

## NOTES

Calling this function before a group has been fully joined results in canceling the join operation.  Users should be aware that messages received from the multicast group may stilled be queued for completion processing immediately after leaving a multicast group. Destroying an rdma\_cm\_id will automatically leave all multicast groups.

## SEE ALSO

[rdma\_join\_multicast(3)](/rdma_join_multicast/3.md), [rdma\_destroy\_qp(3)](/rdma_destroy_qp/3.md)