From 8b8fdbdc2e3fef03e21177eb3710491e4c080d43 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Thu, 23 Jan 2020 23:24:04 -0800 Subject: Publishing updates for v1.2.4 --- man/v1.2.4/nng_dialer.5.html | 151 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 man/v1.2.4/nng_dialer.5.html (limited to 'man/v1.2.4/nng_dialer.5.html') diff --git a/man/v1.2.4/nng_dialer.5.html b/man/v1.2.4/nng_dialer.5.html new file mode 100644 index 00000000..5c79756b --- /dev/null +++ b/man/v1.2.4/nng_dialer.5.html @@ -0,0 +1,151 @@ +--- +version: v1.2.4 +layout: refman +--- + + + + + + + +nng_dialer(5) + + + + + + +
+
+

SYNOPSIS

+
+
+
+
#include <nng/nng.h>
+
+typedef struct nng_dialer_s nng_dialer;
+
+
+
+
+
+

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 “owned” +by 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 “owning” 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.

+
+
+
+
+
+

SEE ALSO

+
+
+

nng_dial(3), +nng_dialer_close(3), +nng_dialer_create(3), +nng_dialer_getopt(3), +nng_dialer_id(3), +nng_dialer_setopt(3), +nng_dialer_start(3), +nng_listener(5), +nng_pipe(5), +nng_socket(5), +nng(7)

+
+
+
+
+ + + \ No newline at end of file -- cgit v1.2.3-70-g09d2