---
name: "rpma_peer_delete"
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_peer_delete"
---

# rpma\_peer\_delete(3)

delete a peer object

## NAME

**rpma\_peer\_delete** - delete a peer object

## SYNOPSIS

```
      #include <librpma.h>
      struct rpma_peer;
      int rpma_peer_delete(struct rpma_peer **peer_ptr);
```

## DESCRIPTION

**rpma\_peer\_delete**() deletes the peer object.

## RETURN VALUE

The **rpma\_peer\_delete**() function returns 0 on success or a negative error code on failure. **rpm\_peer\_delete**() does not set \*peer\_ptr value to NULL on failure.

## RETURN VALUE

The **rpma\_peer\_delete**() function returns 0 on success or a negative error code on failure. **rpma\_peer\_delete**() does not set \*peer\_ptr to NULL on failure.

## ERRORS

**rpma\_peer\_delete**() can fail with the following error:

- •

  RPMA\_E\_PROVIDER - deleting the verbs protection domain failed.

## SEE ALSO

[**rpma\_peer\_new**(3)](/rpma_peer_new/3.md), [**librpma**(7)](/librpma/7.md) and https://pmem.io/rpma/