---
name: "rpma_peer_cfg_new"
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_cfg_new"
---

# rpma\_peer\_cfg\_new(3)

create a new peer configuration object

## NAME

**rpma\_peer\_cfg\_new** - create a new peer configuration object

## SYNOPSIS

```
      #include <librpma.h>
      struct rpma_peer_cfg;
      int rpma_peer_cfg_new(struct rpma_peer_cfg **pcfg_ptr);
```

## DESCRIPTION

**rpma\_peer\_cfg\_new**() creates a new peer configuration object.

## RETURN VALUE

The **rpma\_peer\_cfg\_new**() function returns 0 on success or a negative error code on failure. **rpm\_peer\_cfg\_new**() does not set \*pcfg\_ptr value on failure.

## ERRORS

**rpma\_peer\_cfg\_new**() can fail with the following errors:

- •

  RPMA\_E\_INVAL - pcfg\_ptr is NULL

- •

  RPMA\_E\_NOMEM - out of memory

## SEE ALSO

[**rpma\_conn\_apply\_remote\_peer\_cfg**(3)](/rpma_conn_apply_remote_peer_cfg/3.md), [**rpma\_peer\_cfg\_delete**(3)](/rpma_peer_cfg_delete/3.md), [**rpma\_peer\_cfg\_from\_descriptor**(3)](/rpma_peer_cfg_from_descriptor/3.md), [**rpma\_peer\_cfg\_get\_descriptor**(3)](/rpma_peer_cfg_get_descriptor/3.md), [**rpma\_peer\_cfg\_get\_descriptor\_size**(3)](/rpma_peer_cfg_get_descriptor_size/3.md), [**rpma\_peer\_cfg\_get\_direct\_write\_to\_pmem**(3)](/rpma_peer_cfg_get_direct_write_to_pmem/3.md), [**rpma\_peer\_cfg\_set\_direct\_write\_to\_pmem**(3)](/rpma_peer_cfg_set_direct_write_to_pmem/3.md), [**librpma**(7)](/librpma/7.md) and https://pmem.io/rpma/