From bce3ca536ff7e3cba601138bda1ba4ce77d55270 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Thu, 23 Jan 2020 23:43:07 -0800 Subject: Publishing updates for v1.1.1 --- man/v1.1.1/nng_socket.5.html | 121 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 man/v1.1.1/nng_socket.5.html (limited to 'man/v1.1.1/nng_socket.5.html') diff --git a/man/v1.1.1/nng_socket.5.html b/man/v1.1.1/nng_socket.5.html new file mode 100644 index 00000000..0da07dcd --- /dev/null +++ b/man/v1.1.1/nng_socket.5.html @@ -0,0 +1,121 @@ +--- +version: v1.1.1 +layout: refman +--- + + + + + + + +nng_socket(5) + + + + + + +
+
+

SYNOPSIS

+
+
+
+
#include <nng/nng.h>
+
+typedef struct nng_socket_s nng_socket;
+
+
+
+
+
+

DESCRIPTION

+
+
+

An nng_socket is a handle to an underlying “socket” object. +All communication between the application and remote Scalability Protocol +peers is done through sockets. +A given socket can have multiple dialers (nng_dialer) +and/or listeners (nng_listener), and multiple +pipes (nng_pipe), and +may be connected to multiple transports at the same time. +However, a given socket will have exactly one “protocol” associated with it, +and is responsible for any state machines or other protocol-specific logic.

+
+
+ + + + + +
+ + +The nng_socket structure is always passed by value (both +for input parameters and return values), and should be treated opaquely. +Passing structures this way ensures gives the compiler a chance to perform +accurate type checks in functions passing values of this type. +
+
+
+

Each nng_socket is created by a protocol-specific constructor, such as +nng_rep_open(). +When the socket is no longer needed, it can be closed with +nng_close().

+
+
+

Initialization

+
+

A socket may be initialized using the macro NNG_SOCKET_INITIALIZER +before it is opened, to prevent confusion with valid open sockets.

+
+
+

For example:

+
+
+
+
nng_socket s = NNG_SOCKET_INITIALIZER;
+
+
+
+
+
+ +
+ + + \ No newline at end of file -- cgit v1.2.3-70-g09d2