---
name: "rpma_conn_disconnect"
section: "3"
platform: "linux"
package: "librpma-dev"
version: "1.3.0-2+b3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rpma_conn_disconnect"
---

# rpma\_conn\_disconnect(3)

tear the connection down

## NAME

**rpma\_conn\_disconnect** - tear the connection down

## SYNOPSIS

```
      #include <librpma.h>
      struct rpma_conn;
      int rpma_conn_disconnect(struct rpma_conn *conn);
```

## DESCRIPTION

**rpma\_conn\_disconnect**() tears the connection down.

- •

  It may initiate disconnecting the connection. In this case, the end of disconnecting is signalled by the RPMA\_CONN\_CLOSED event via **rpma\_conn\_next\_event**() or

- •

  It may be called after receiving the RPMA\_CONN\_CLOSED event. In this case, the disconnection is done when **rpma\_conn\_disconnect**() returns with success.

## RETURN VALUE

The **rpma\_conn\_disconnect**() function returns 0 on success or a negative error code on failure.

## ERRORS

**rpma\_conn\_disconnect**() can fail with the following errors:

- •

  RPMA\_E\_INVAL - conn is NULL

- •

  RPMA\_E\_PROVIDER - **rdma\_disconnect**() failed

## SEE ALSO

[**rpma\_conn\_delete**(3)](/rpma_conn_delete/3.md), [**rpma\_conn\_next\_event**(3)](/rpma_conn_next_event/3.md), [**rpma\_conn\_req\_connect**(3)](/rpma_conn_req_connect/3.md), [**librpma**(7)](/librpma/7.md) and https://pmem.io/rpma/