---
name: "rpma_conn_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_conn_cfg_new"
---

# rpma\_conn\_cfg\_new(3)

create a new connection configuration object

## NAME

**rpma\_conn\_cfg\_new** - create a new connection configuration object

## SYNOPSIS

```
      #include <librpma.h>
      struct rpma_conn_cfg;
      int rpma_conn_cfg_new(struct rpma_conn_cfg **cfg_ptr);
```

## DESCRIPTION

**rpma\_conn\_cfg\_new**() creates a new connection configuration object and fills it with the default values:

```
        .timeout_ms = 1000
        .cq_size = 10
        .rcq_size = 0
        .sq_size = 10
        .rq_size = 10
        .shared_comp_channel = false
```

## RETURN VALUE

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

## ERRORS

**rpma\_conn\_cfg\_new**() can fail with the following error:

- •

  RPMA\_E\_INVAL - cfg\_ptr is NULL

- •

  RPMA\_E\_NOMEM - out of memory

## SEE ALSO

[**rpma\_conn\_cfg\_delete**(3)](/rpma_conn_cfg_delete/3.md), [**rpma\_conn\_cfg\_get\_compl\_channel**(3)](/rpma_conn_cfg_get_compl_channel/3.md), [**rpma\_conn\_cfg\_get\_cq\_size**(3)](/rpma_conn_cfg_get_cq_size/3.md), [**rpma\_conn\_cfg\_get\_rq\_size**(3)](/rpma_conn_cfg_get_rq_size/3.md), [**rpma\_conn\_cfg\_get\_sq\_size**(3)](/rpma_conn_cfg_get_sq_size/3.md), [**rpma\_conn\_cfg\_get\_timeout**(3)](/rpma_conn_cfg_get_timeout/3.md), [**rpma\_conn\_cfg\_set\_compl\_channel**(3)](/rpma_conn_cfg_set_compl_channel/3.md), [**rpma\_conn\_cfg\_set\_cq\_size**(3)](/rpma_conn_cfg_set_cq_size/3.md), [**rpma\_conn\_cfg\_set\_rq\_size**(3)](/rpma_conn_cfg_set_rq_size/3.md), [**rpma\_conn\_cfg\_set\_sq\_size**(3)](/rpma_conn_cfg_set_sq_size/3.md), [**rpma\_conn\_cfg\_set\_timeout**(3)](/rpma_conn_cfg_set_timeout/3.md), [**rpma\_conn\_req\_new**(3)](/rpma_conn_req_new/3.md), [**rpma\_ep\_next\_conn\_req**(3)](/rpma_ep_next_conn_req/3.md), [**librpma**(7)](/librpma/7.md) and https://pmem.io/rpma/