---
name: "nng_dialer_create"
section: "3"
platform: "linux"
package: "libnng-dev"
version: "1.10.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/nng_dialer_create"
---

# nng\_dialer\_create(3)

create dialer

## NAME

nng\_dialer\_create - create dialer

## SYNOPSIS

```
#include <nng/nng.h>
int nng_dialer_create(nng_dialer *dialerp, nng_socket s, const char *url);
```

## DESCRIPTION

The `nng_dialer_create()` function creates a newly initialized `nng_dialer` object, associated with socket *s*, and configured to connect to the address specified by *url*, and stores a pointer to at the location referenced by *dialerp*.

Dialers initiate a remote connection to a listener. Upon a successful connection being established, they create a pipe, add it to the socket, and then wait for that pipe to be closed. When the pipe is closed, they will re-initiate the connection. Dialers will also periodically retry a connection automatically if an attempt to connect asynchronously fails.

**Tip**\

While it is convenient to think of dialers as clients, the relationship between the listener or dialer is orthogonal to any server or client status that might be associated with a given protocol. For example, a *req* socket might have associated dialers, but might also have associated listeners. It may even have some of each at the same time!

The dialer is not started, but may be further configured with the `nng_dialer_setopt()` family of functions.

Once it is fully configured, the dialer may be started using the `nng_dialer_start()` function.

**Tip**\

If no specific configuration is required, consider using the simpler `nng_dial()` function instead.

## RETURN VALUES

This function returns 0 on success, and non-zero otherwise.

## ERRORS

`NNG_EADDRINVAL`

An invalid *url* was specified.

`NNG_ECLOSED`

The socket *s* is not open.

`NNG_ENOMEM`

Insufficient memory is available.

## SEE ALSO

[nng\_dial(3)](/nng_dial/3.md), [nng\_dialer\_close(3)](/nng_dialer_close/3.md), [nng\_dialer\_getopt(3)](/nng_dialer_getopt/3.md), [nng\_dialer\_setopt(3)](/nng_dialer_setopt/3.md), [nng\_dialer\_start(3)](/nng_dialer_start/3.md), [nng\_listener\_create(3)](/nng_listener_create/3.md) [nng\_strerror(3)](/nng_strerror/3.md), [nng\_dialer(5)](/nng_dialer/5.md), [nng(7)](/nng/7.md)