#include <nng/nng.h>
typedef struct nng_dialer_s nng_dialer;| This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.8.0. See the documentation for v1.8.0 for the most up-to-date information. |
nng_dialer(5)
NAME
nng_dialer - dialer
SYNOPSIS
DESCRIPTION
An nng_dialer is a handle to a dialer object, which is responsible for
creating a single nng_pipe at a time by
establishing an outgoing connection.
If the connection is broken, or fails, the dialer object will automatically attempt to reconnect, and will keep doing so until the dialer or socket is destroyed.
Dialer objects are created by the
nng_dialer_create()
or nng_dial() functions, and are always associated
with a single nng_socket.
The nng_dialer structure is always passed by value (both
for input parameters and return values), and should be treated opaquely.
Passing structures this way gives the compiler a chance to perform
accurate type checks in functions passing values of this type.
|
A given nng_socket may have multiple dialer
objects, multiple listener objects, or even some
of both.
|
| The client/server relationship described by dialer/listener is completely orthogonal to any similar relationship in the protocols. For example, a rep socket may use a dialer to connect to a listener on an req socket. This orthogonality can lead to innovative solutions to otherwise challenging communications problems. |
Dialer objects may be destroyed by the
nng_dialer_close() function.
They are also closed when their associated socket is closed.
Initialization
A dialer may be initialized using the macro NNG_DIALER_INITIALIZER
before it is opened, to prevent confusion with valid open dialers.