diff options
Diffstat (limited to 'ref/print.html')
| -rw-r--r-- | ref/print.html | 198 |
1 files changed, 97 insertions, 101 deletions
diff --git a/ref/print.html b/ref/print.html index bcf779df..9725c938 100644 --- a/ref/print.html +++ b/ref/print.html @@ -3782,7 +3782,6 @@ int nng_stream_get_ms(nng_stream *s, const char *opt, nng_duration *valp); int nng_stream_get_size(nng_stream *s, const char *opt, size_t *valp); int nng_stream_get_addr(nng_stream *s, const char *opt, nng_sockaddr *valp); int nng_stream_get_string(nng_stream *s, const char *opt, char **valp); -int nng_stream_get_uint64(nng_stream *s, const char *opt, uint64_t *valp); </code></pre> <p><a name="a008"></a> <a name="a009"></a> @@ -3790,7 +3789,6 @@ int nng_stream_get_uint64(nng_stream *s, const char *opt, uint64_t *valp); <a name="a011"></a> <a name="a012"></a> <a name="a013"></a> -<a name="a014"></a> These functions are used to obtain value of an option named <em>opt</em> from the stream <em>s</em>, and store it in the location referenced by <em>valp</em>.</p> <p>These functions access an option as a specific type. The transport layer will have details about which options @@ -3801,25 +3799,25 @@ the caller using <a href="api//api/memory.html#free-string"><code>nng_strfree</c <pre><code class="language-c">typedef struct nng_stream_dialer nng_stream_dialer; typedef struct nng_stream_listener nng_stream_listener; </code></pre> -<p><a name="a015"></a> -The <a name="a016"></a><code>nng_stream_listener</code> object and <a name="a017"></a><code>nng_stream_listener</code> objects can be thought of as factories that +<p><a name="a014"></a> +The <a name="a015"></a><code>nng_stream_listener</code> object and <a name="a016"></a><code>nng_stream_listener</code> objects can be thought of as factories that create <a href="api//api/stream.html#stream-type"><code>nng_stream</code></a> streams.</p> <p>The <code>nng_stream_listener</code> object a handle to a listener, which creates streams by accepting incoming connection requests. -In a BSD socket implementation, this is the entity responsible for doing <a name="a018"></a><code>bind</code>, <a name="a019"></a><code>listen</code> and <a name="a020"></a><code>accept</code>. +In a BSD socket implementation, this is the entity responsible for doing <a name="a017"></a><code>bind</code>, <a name="a018"></a><code>listen</code> and <a name="a019"></a><code>accept</code>. Normally a listener may be used to accept multiple, possibly many, concurrent connections.</p> <p>The <code>nng_stream_dialer</code> object is a handle to a dialer, which creates streams by making outgoing connection requests. While there isn’t a specific BSD socket analogue, this can be thought of as a factory for TCP sockets -created by opening them with <a name="a021"></a><code>socket</code> and then calling <a name="a022"></a><code>connect</code> on them.</p> +created by opening them with <a name="a020"></a><code>socket</code> and then calling <a name="a021"></a><code>connect</code> on them.</p> <h2 id="creating-a-stream-factory"><a class="header" href="#creating-a-stream-factory">Creating a Stream Factory</a></h2> <pre><code class="language-c">int nng_stream_dialer_alloc(nng_stream_dialer **dialerp, const char *url); int nng_stream_dialer_alloc_url(nng_stream_dialer **dialerp, const nng_url *url); int nng_stream_listener_alloc(nng_stream_listener **lstenerp, const char *url); int nng_stream_listener_alloc_url(nng_stream_listener **listenerp, const nng_url *url); </code></pre> -<p>The <a name="a023"></a><code>nng_stream_dialer_alloc</code> and <a name="a024"></a><code>nng_stream_dialer_alloc_url</code> functions create a stream dialer, associated the -<a name="a025"></a>URL specified by <em>url</em> represented as a string, or as an <a href="api//api/url.html#url-structure"><code>nng_url</code></a> object, respectively. The dialer is returned in the location +<p>The <a name="a022"></a><code>nng_stream_dialer_alloc</code> and <a name="a023"></a><code>nng_stream_dialer_alloc_url</code> functions create a stream dialer, associated the +<a name="a024"></a>URL specified by <em>url</em> represented as a string, or as an <a href="api//api/url.html#url-structure"><code>nng_url</code></a> object, respectively. The dialer is returned in the location <em>dialerp</em> references.</p> -<p>The <a name="a026"></a><code>nng_stream_listener_alloc</code> and <a name="a027"></a><code>nng_stream_listener_alloc_url</code> functions create a stream listener, associated the +<p>The <a name="a025"></a><code>nng_stream_listener_alloc</code> and <a name="a026"></a><code>nng_stream_listener_alloc_url</code> functions create a stream listener, associated the URL specified by <em>url</em> represented as a string, or as an <a href="api//api/url.html#url-structure"><code>nng_url</code></a> object, respectively. The listener is returned in the location <em>listenerp</em> references.</p> <h3 id="example-1-creating-a-tcp-listener"><a class="header" href="#example-1-creating-a-tcp-listener">Example 1: Creating a TCP Listener</a></h3> @@ -3835,14 +3833,14 @@ void nng_stream_listener_close(nng_stream_listener *listener); void nng_stream_listener_stop(nng_stream_listener *listener); void nng_stream_listener_free(nng_stream_listener *listener); </code></pre> -<p>The <a name="a028"></a><code>nng_stream_dialer_close</code> and <a name="a029"></a><code>nng_stream_listener_close</code> functions close the stream <em>dialer</em> or <em>listener</em>, +<p>The <a name="a027"></a><code>nng_stream_dialer_close</code> and <a name="a028"></a><code>nng_stream_listener_close</code> functions close the stream <em>dialer</em> or <em>listener</em>, preventing it from creating new connections. This will generally include closing any underlying file used for creating such connections. However, some requests may still be pending when this function returns, as it does not wait for the shutdown to complete.</p> -<p>The <a name="a030"></a><code>nng_stream_dialer_stop</code> and <a name="a031"></a><code>nng_stream_listener_stop</code> functions performs the same action, +<p>The <a name="a029"></a><code>nng_stream_dialer_stop</code> and <a name="a030"></a><code>nng_stream_listener_stop</code> functions performs the same action, but also wait until all outstanding requests are serviced, and the <em>dialer</em> or <em>listener</em> is completely stopped. Because they blocks, these functions must not be called in contexts where blocking is not allowed.</p> -<p>The <a name="a032"></a><code>nng_stream_dialer_free</code> and <a name="a033"></a><code>nng_stream_listener_free</code> function performs the same action as +<p>The <a name="a031"></a><code>nng_stream_dialer_free</code> and <a name="a032"></a><code>nng_stream_listener_free</code> function performs the same action as <code>nng_stream_dialer_stop</code> or <code>nng_stream_listener_stop</code>, but also deallocates the <em>dialer</em> or <em>listener</em>, and any associated resources.</p> <div class="mdbook-alerts mdbook-alerts-tip"> <p class="mdbook-alerts-title"> @@ -3855,7 +3853,7 @@ callbacks are running that could reference an object after it is deallocated.</p <h2 id="making-outgoing-connections"><a class="header" href="#making-outgoing-connections">Making Outgoing Connections</a></h2> <pre><code class="language-c">void nng_stream_dialer_dial(nng_stream_dialer *dialer, nng_aio *aio); </code></pre> -<p>The <a name="a034"></a><code>nng_stream_dialer_dial</code> initiates an outgoing connection asynchronously, using the <a href="api//api/aio.html#asynchronous-io-handle"><code>nng_aio</code></a> <em>aio</em>. +<p>The <a name="a033"></a><code>nng_stream_dialer_dial</code> initiates an outgoing connection asynchronously, using the <a href="api//api/aio.html#asynchronous-io-handle"><code>nng_aio</code></a> <em>aio</em>. If it successfully establishes a connection, it creates an <a href="api//api/stream.html#stream-type"><code>nng_stream</code></a>, which can be obtained as the first output result on <em>aio</em> using the <a href="api//api/aio.html#inputs-and-outputs"><code>nng_aio_get_output</code></a> function with index zero.</p> <div class="mdbook-alerts mdbook-alerts-tip"> @@ -3889,10 +3887,10 @@ stream = nng_aio_get_output(aio, 0); <pre><code class="language-c">int nng_stream_listener_listen(nng_stream_listener *listener); void nng_stream_listener_accept(nng_stream_listener *listener, nng_aio *aio); </code></pre> -<p>Accepting incoming connections is performed in two steps. The first step, <a name="a035"></a><code>nng_stream_listener_listen</code> is to setup for +<p>Accepting incoming connections is performed in two steps. The first step, <a name="a034"></a><code>nng_stream_listener_listen</code> is to setup for listening. For a TCP implementation of this, for example, this would perform the <code>bind</code> and the <code>listen</code> steps. This will bind to the address represented by the URL that was specific when the listener was created with <a href="api//api/stream.html#creating-a-stream-factory"><code>nng_stream_listener_alloc</code></a>.</p> -<p>In the second step, <a name="a036"></a><code>nng_stream_listener_accept</code> accepts an incoming connection on <em>listener</em> asynchronously, using the <a href="api//api/aio.html#asynchronous-io-handle"><code>nng_aio</code></a> <em>aio</em>. +<p>In the second step, <a name="a035"></a><code>nng_stream_listener_accept</code> accepts an incoming connection on <em>listener</em> asynchronously, using the <a href="api//api/aio.html#asynchronous-io-handle"><code>nng_aio</code></a> <em>aio</em>. If an incoming connection is accepted, it will be represented as an <a href="api//api/stream.html#stream-type"><code>nng_stream</code></a>, which can be obtained from the <em>aio</em> as the first output result using the <a href="api//api/aio.html#inputs-and-outputs"><code>nng_aio_get_output</code></a> function with index zero.</p> <h3 id="example-3-accepting-an-inbound-stream"><a class="header" href="#example-3-accepting-an-inbound-stream">Example 3: Accepting an Inbound Stream</a></h3> @@ -3919,39 +3917,36 @@ if (nng_aio_result(aio) != 0) { stream = nng_aio_get_output(aio, 0); </code></pre> <h2 id="stream-factory-options"><a class="header" href="#stream-factory-options">Stream Factory Options</a></h2> -<pre><code class="language-c">int nng_stream_dialer_get_bool(nng_stream_dialer *dialer, const char *opt, bool *valp); +<pre><code class="language-c">int nng_stream_dialer_get_addr(nng_stream_dialer *dialer, const char *opt, nng_sockaddr *valp); +int nng_stream_dialer_get_bool(nng_stream_dialer *dialer, const char *opt, bool *valp); int nng_stream_dialer_get_int(nng_stream_dialer *dialer, const char *opt, int *valp); int nng_stream_dialer_get_ms(nng_stream_dialer *dialer, const char *opt, nng_duration *valp); int nng_stream_dialer_get_size(nng_stream_dialer *dialer, const char *opt, size_t *valp); -int nng_stream_dialer_get_addr(nng_stream_dialer *dialer, const char *opt, nng_sockaddr *valp); int nng_stream_dialer_get_string(nng_stream_dialer *dialer, const char *opt, char **valp); -int nng_stream_dialer_get_uint64(nng_stream_dialer *dialer, const char *opt, uint64_t *valp); +int nng_stream_listener_get_addr(nng_stream_listener *listener, const char *opt, nng_sockaddr *valp); int nng_stream_listener_get_bool(nng_stream_listener *listener, const char *opt, bool *valp); int nng_stream_listener_get_int(nng_stream_listener *listener, const char *opt, int *valp); int nng_stream_listener_get_ms(nng_stream_listener *listener, const char *opt, nng_duration *valp); int nng_stream_listener_get_size(nng_stream_listener *listener, const char *opt, size_t *valp); -int nng_stream_listener_get_addr(nng_stream_listener *listener, const char *opt, nng_sockaddr *valp); int nng_stream_listener_get_string(nng_stream_listener *listener, const char *opt, char **valp); -int nng_stream_listener_get_uint64(nng_stream_listener *listener, const char *opt, uint64_t *valp); +int nng_stream_dialer_set_addr(nng_stream_dialer *dialer, const char *opt, const nng_sockaddr *val); int nng_stream_dialer_set_bool(nng_stream_dialer *dialer, const char *opt, bool val); int nng_stream_dialer_set_int(nng_stream_dialer *dialer, const char *opt, int val); int nng_stream_dialer_set_ms(nng_stream_dialer *dialer, const char *opt, nng_duration val); int nng_stream_dialer_set_size(nng_stream_dialer *dialer, const char *opt, size_t val); int nng_stream_dialer_set_string(nng_stream_dialer *dialer, const char *opt, const char *val); -int nng_stream_dialer_set_uint64(nng_stream_dialer *dialer, const char *opt, uint64_t val); -int nng_stream_dialer_set_addr(nng_stream_dialer *dialer, const char *opt, const nng_sockaddr *val); +int nng_stream_listener_set_addr(nng_stream_listener *listener, const char *opt, const nng_sockaddr *val); int nng_stream_listener_set_bool(nng_stream_listener *listener, const char *opt, bool val); int nng_stream_listener_set_int(nng_stream_listener *listener, const char *opt, int val); int nng_stream_listener_set_ms(nng_stream_listener *listener, const char *opt, nng_duration val); int nng_stream_listener_set_size(nng_stream_listener *listener, const char *opt, size_t val); int nng_stream_listener_set_string(nng_stream_listener *listener, const char *opt, const char *val); -int nng_stream_listener_set_uint64(nng_stream_listener *listener, const char *opt, uint64_t val); -int nng_stream_listener_set_addr(nng_stream_listener *listener, const char *opt, const nng_sockaddr *val); </code></pre> -<p><a name="a037"></a> +<p><a name="a036"></a> +<a name="a037"></a> <a name="a038"></a> <a name="a039"></a> <a name="a040"></a> @@ -3974,11 +3969,6 @@ int nng_stream_listener_set_addr(nng_stream_listener *listener, const char *opt, <a name="a057"></a> <a name="a058"></a> <a name="a059"></a> -<a name="a060"></a> -<a name="a061"></a> -<a name="a062"></a> -<a name="a063"></a> -<a name="a064"></a> These functions are used to retrieve or change the value of an option named <em>opt</em> from the stream <em>dialer</em> or <em>listener</em>. The <code>nng_stream_dialer_get_</code> and <code>nng_stream_listener_get_</code> function families retrieve the value, and store it in the location <em>valp</em> references. The <code>nng_stream_dialer_set_</code> and <code>nng_stream_listener_set_</code> function families change the value for the <em>dialer</em> or <em>listener</em>, taking it from <em>val</em>.</p> @@ -3991,9 +3981,9 @@ need not retain the value referenced once the function returns.</p> <p>In the case of <code>nng_stream_dialer_set_addr</code> and <code>nng_stream_listener_set_addr</code>, the contents of <em>addr</em> are copied if necessary, so that the caller need not retain the value referenced once the function returns.</p> <h3 id="example-4-socket-activation"><a class="header" href="#example-4-socket-activation">Example 4: Socket Activation<a name="socket-activation"></a></a></h3> -<p>Some <a href="api//api/stream.html#stream-factories"><code>nng_stream_listener</code></a> objects, depending on the underlying transport and platform, can support a technique known as “<a name="a065"></a>socket activation”, +<p>Some <a href="api//api/stream.html#stream-factories"><code>nng_stream_listener</code></a> objects, depending on the underlying transport and platform, can support a technique known as “<a name="a060"></a>socket activation”, where the file descriptor used for listening and accepting is supplied externally, such as by a system service manager. -In this case, the application supplies the file descriptor or <code>SOCKET</code> object using the <a name="a066"></a><code>NNG_OPT_LISTEN_FD</code> option, +In this case, the application supplies the file descriptor or <code>SOCKET</code> object using the <a name="a061"></a><code>NNG_OPT_LISTEN_FD</code> option, instead of calling <a href="api//api/stream.html#accepting-incoming-connections"><code>nng_stream_listener_listen</code></a>.</p> <div class="mdbook-alerts mdbook-alerts-tip"> <p class="mdbook-alerts-title"> @@ -4021,13 +4011,13 @@ int nng_stream_dialer_set_tls(nng_stream_listener *dialer, nng_tls_config *tls); int nng_stream_listener_get_tls(nng_stream_listener *listener, nng_tls_config **tlsp); int nng_stream_listener_set_tls(nng_stream_listener *listener, nng_tls_config *tls); </code></pre> -<p>Both <a href="api//api/stream.html#stream-factories"><code>nng_stream_dialer</code></a> and <a href="api//api/stream.html#stream-factories"><code>nng_stream_listener</code></a> objects may support configuration of <a name="a067"></a>TLS parameters. -The <a name="a068"></a><code>nng_stream_dialer_set_tls</code> and <a name="a069"></a><code>nng_stream_listener_set_tls</code> functions support setting the +<p>Both <a href="api//api/stream.html#stream-factories"><code>nng_stream_dialer</code></a> and <a href="api//api/stream.html#stream-factories"><code>nng_stream_listener</code></a> objects may support configuration of <a name="a062"></a>TLS parameters. +The <a name="a063"></a><code>nng_stream_dialer_set_tls</code> and <a name="a064"></a><code>nng_stream_listener_set_tls</code> functions support setting the configuration of a <a href="api//TODO.html"><code>nng_tls_config</code></a> object supplied by <em>tls</em> on <em>dialer</em> or <em>listener</em>. This must be performed before the <em>listener</em> starts listening with <a href="api//api/stream.html#accepting-incoming-connections"><code>nng_stream_listener_listen</code></a>, or the dialer starts an outgoing connection as a result of <a href="api//api/stream.html#making-outgoing-connections"><code>nng_stream_dialer_dial</code></a>.</p> <p>The configuration object that was previously established (which may be a default if one was not explicitly -configured) can be obtained with the <a name="a070"></a><code>nng_stream_dialer_get_tls</code> and <a name="a071"></a><code>nng_stream_listener_get_tls</code>. +configured) can be obtained with the <a name="a065"></a><code>nng_stream_dialer_get_tls</code> and <a name="a066"></a><code>nng_stream_listener_get_tls</code>. They will return a pointer to the <a href="api//TODO.html"><code>nng_tls_config</code></a> object in question at the location referenced by <em>tlsp</em>.</p> <div class="mdbook-alerts mdbook-alerts-note"> <p class="mdbook-alerts-title"> @@ -6291,10 +6281,10 @@ where supported by the underlying platform.</p> <tr><td><code>NNG_OPT_IPC_PERMISSIONS</code></td><td><code>int</code></td><td>Settable on listeners before they start, this is the UNIX file mode used when creating the socket.</td></tr> <tr><td><code>NNG_OPT_LOCADDR</code></td><td><a href="tran//TODO.html"><code>nng_sockaddr</code></a></td><td>Local socket address, either <a href="tran//TODO.html"><code>nng_sockaddr_ipc</code></a> or <a href="tran//TODO.html"><code>nng_sockaddr_abstract</code></a>.</td></tr> <tr><td><code>NNG_OPT_REMADDR</code></td><td><a href="tran//TODO.html"><code>nng_sockaddr</code></a></td><td>Remote socket address, either <a href="tran//TODO.html"><code>nng_sockaddr_ipc</code></a> or <a href="tran//TODO.html"><code>nng_sockaddr_abstract</code></a>.</td></tr> -<tr><td><code>NNG_OPT_PEER_GID</code></td><td><code>uint64_t</code></td><td>Read only option, returns the group ID of the process at the other end of the socket, if platform supports it.</td></tr> -<tr><td><code>NNG_OPT_PEER_PID</code></td><td><code>uint64_t</code></td><td>Read only option, returns the processed ID of the process at the other end of the socket, if platform supports it.</td></tr> -<tr><td><code>NNG_OPT_PEER_UID</code></td><td><code>uint64_t</code></td><td>Read only option, returns the user ID of the process at the other end of the socket, if platform supports it.</td></tr> -<tr><td><code>NNG_OPT_PEER_ZONEID</code></td><td><code>uint64_t</code></td><td>Read only option, returns the zone ID of the process at the other end of the socket, if platform supports it.</td></tr> +<tr><td><code>NNG_OPT_PEER_GID</code></td><td><code>int</code></td><td>Read only option, returns the group ID of the process at the other end of the socket, if platform supports it.</td></tr> +<tr><td><code>NNG_OPT_PEER_PID</code></td><td><code>int</code></td><td>Read only option, returns the processed ID of the process at the other end of the socket, if platform supports it.</td></tr> +<tr><td><code>NNG_OPT_PEER_UID</code></td><td><code>int</code></td><td>Read only option, returns the user ID of the process at the other end of the socket, if platform supports it.</td></tr> +<tr><td><code>NNG_OPT_PEER_ZONEID</code></td><td><code>int</code></td><td>Read only option, returns the zone ID of the process at the other end of the socket, if platform supports it.</td></tr> <tr><td><a href="tran//api/streams.html#socket-activation"><code>NNG_OPT_LISTEN_FD</code></a></td><td><code>int</code></td><td>Write only for listeners before they start, use the named socket for accepting (for use with socket activation).</td></tr> </tbody></table> </div> @@ -6416,10 +6406,10 @@ There are no further socket details available.</p> <p>The following transport options are supported by this transport.</p> <div class="table-wrapper"><table><thead><tr><th>Option</th><th>Type</th><th>Description</th></tr></thead><tbody> <tr><td><code>NNG_OPT_SOCKET_FD</code></td><td><code>int</code></td><td>Write-only option, that may be set multiple times on a listener. Each time this is set, the listener will create a <a href="tran//TODO.html">pipe</a> backed by the given file descriptor passed as an argument.</td></tr> -<tr><td><code>NNG_OPT_PEER_GID</code></td><td><code>uint64_t</code></td><td>Read only option, returns the group ID of the process at the other end of the socket, if platform supports it.</td></tr> -<tr><td><code>NNG_OPT_PEER_PID</code></td><td><code>uint64_t</code></td><td>Read only option, returns the processed ID of the process at the other end of the socket, if platform supports it.</td></tr> -<tr><td><code>NNG_OPT_PEER_UID</code></td><td><code>uint64_t</code></td><td>Read only option, returns the user ID of the process at the other end of the socket, if platform supports it.</td></tr> -<tr><td><code>NNG_OPT_PEER_ZONEID</code></td><td><code>uint64_t</code></td><td>Read only option, returns the zone ID of the process at the other end of the socket, if platform supports it.</td></tr> +<tr><td><code>NNG_OPT_PEER_GID</code></td><td><code>int</code></td><td>Read only option, returns the group ID of the process at the other end of the socket, if platform supports it.</td></tr> +<tr><td><code>NNG_OPT_PEER_PID</code></td><td><code>int</code></td><td>Read only option, returns the processed ID of the process at the other end of the socket, if platform supports it.</td></tr> +<tr><td><code>NNG_OPT_PEER_UID</code></td><td><code>int</code></td><td>Read only option, returns the user ID of the process at the other end of the socket, if platform supports it.</td></tr> +<tr><td><code>NNG_OPT_PEER_ZONEID</code></td><td><code>int</code></td><td>Read only option, returns the zone ID of the process at the other end of the socket, if platform supports it.</td></tr> </tbody></table> </div><div class="mdbook-alerts mdbook-alerts-note"> <p class="mdbook-alerts-title"> @@ -6847,6 +6837,9 @@ to when dialing, by using the local address in front of the destination address separated by a semicolon. This was provided for legacy libnanomsg compatilibility, and is no longer offered. The correct way to specify a local address is by setting <code>NNG_OPT_LOCADDR</code> on the dialer.</p> +<h2 id="ipc-option-type-changes"><a class="header" href="#ipc-option-type-changes">IPC Option Type Changes</a></h2> +<p>The types of <a href="migrate//tran/ipc.html#NNG_OPT_PEER_GID"><code>NNG_OPT_PEER_GID</code></a>, <a href="migrate//tran/ipc.html#NNG_OPT_PEER_PID"><code>NNG_OPT_PEER_PID</code></a>, <a href="migrate//tran/ipc.html#NNG_OPT_PEER_UID"><code>NNG_OPT_PEER_UID</code></a>, and <a href="migrate//tran/ipc.html#NNG_OPT_PEER_ZONEID"><code>NNG_OPT_PEER_ZONEID</code></a> +have changed from <code>uint64_t</code> to <code>int</code>. The underlying platforms all use 32-bit quantities for these.</p> <h2 id="option-functions"><a class="header" href="#option-functions">Option Functions</a></h2> <p>The previously deprecated <code>nng_pipe_getopt_xxx</code> family of functions is removed. Applications should use <code>nng_pipe_get</code> and related functions instead.</p> @@ -6861,11 +6854,14 @@ and are thus removed:</p> <li><code>nng_ctx_get_string</code></li> <li><code>nng_ctx_set_string</code></li> <li><code>nng_ctx_get_uint64</code></li> -<li><code>nng_ctx_set_uint64</code></li> <li><code>nng_dialer_get_ptr</code></li> <li><code>nng_dialer_set_ptr</code></li> +<li><code>nng_dialer_get_uint64</code></li> +<li><code>nng_dialer_set_uint64</code></li> <li><code>nng_listener_get_ptr</code></li> <li><code>nng_listener_set_ptr</code></li> +<li><code>nng_listener_get_uint64</code></li> +<li><code>nng_listener_set_uint64</code></li> <li><code>nng_socket_get_ptr</code></li> <li><code>nng_socket_set_ptr</code></li> <li><code>nng_socket_get_string</code></li> @@ -6874,10 +6870,15 @@ and are thus removed:</p> <li><code>nng_socket_set_uint64</code></li> <li><code>nng_stream_get_ptr</code></li> <li><code>nng_stream_set_ptr</code></li> +<li><code>nng_stream_get_uint64</code></li> <li><code>nng_stream_dialer_get_ptr</code></li> <li><code>nng_stream_dialer_set_ptr</code></li> +<li><code>nng_stream_dialer_get_uint64</code></li> +<li><code>nng_stream_dialer_set_uint64</code></li> <li><code>nng_stream_listener_get_ptr</code></li> <li><code>nng_stream_listener_set_ptr</code></li> +<li><code>nng_stream_listener_get_uint64</code></li> +<li><code>nng_stream_listener_set_uint64</code></li> <li><code>nng_ctx_get_ptr</code> (not documented)</li> <li><code>nng_ctx_set_ptr</code> (not documented)</li> </ul> @@ -7198,7 +7199,7 @@ dialer before starting to dial.</p> <p>ABI, <a href="api/misc.html#a009">1</a><br/> abstract sockets, <a href="tran/ipc.html#a007">1</a><br/> <code>abstract://</code>, <a href="tran/ipc.html#a008">1</a><br/> -<code>accept</code>, <a href="api/stream.html#a020">1</a><br/> +<code>accept</code>, <a href="api/stream.html#a019">1</a><br/> <code>AF_UNIX</code>, <a href="api/misc.html#a003">1</a><br/> aio, <a href="api/aio.html#a002">1</a><br/> allocations, <a href="api/memory.html#a002">1</a><br/> @@ -7207,7 +7208,7 @@ asynchronous I/O, <a href="api/aio.html#a003">1</a><br/> back-pressure, <a href="proto/index.html#a005">1</a><br/> backtrace, <a href="proto/rep.html#a004">1</a>, <a href="proto/req.html#a008">2</a>, <a href="proto/respondent.html#a004">3</a>, <a href="proto/surveyor.html#a008">4</a><br/> best-effort, <a href="proto/bus.html#a003">1</a><br/> -<code>bind</code>, <a href="api/stream.html#a018">1</a><br/> +<code>bind</code>, <a href="api/stream.html#a017">1</a><br/> body, <a href="api/msg.html#a002">1</a><br/> <em>BUS</em>, <a href="proto/bus.html#a002">1</a><br/> <em>BUS</em> protocol, <a href="proto/bus.html#a001">1</a><br/> @@ -7217,7 +7218,7 @@ command-line arguments, <a href="api/cmd_opts.html#a002">1</a><br/> concurrency, <a href="api/thread.html#a002">1</a><br/> concurrent, <a href="api/ctx.html#a002">1</a><br/> condition variable, <a href="api/synch.html#a009">1</a><br/> -<code>connect</code>, <a href="api/stream.html#a022">1</a><br/> +<code>connect</code>, <a href="api/stream.html#a021">1</a><br/> context, <a href="api/ctx.html#a001">1</a><br/> CPU-bound, <a href="api/thread.html#a003">1</a><br/> duration, <a href="api/time.html#a003">1</a><br/> @@ -7240,7 +7241,7 @@ intra-process, <a href="tran/inproc.html#a003">1</a><br/> IPv4, <a href="tran/udp.html#a003">1</a><br/> IPv6, <a href="tran/udp.html#a004">1</a><br/> leader election, <a href="proto/surveyor.html#a005">1</a><br/> -<code>listen</code>, <a href="api/stream.html#a019">1</a><br/> +<code>listen</code>, <a href="api/stream.html#a018">1</a><br/> load-balancing, <a href="proto/pull.html#a004">1</a>, <a href="proto/push.html#a004">2</a>, <a href="proto/req.html#a005">3</a><br/> Log handlers, <a href="api/logging.html#a007">1</a><br/> memory, <a href="api/memory.html#a001">1</a><br/> @@ -7341,7 +7342,7 @@ named pipes, <a href="tran/ipc.html#a004">1</a><br/> <code>nng_mtx_lock</code>, <a href="api/synch.html#a004">1</a>, <a href="api/synch.html#a006">2</a><br/> <code>nng_mtx_unlock</code>, <a href="api/synch.html#a007">1</a><br/> <code>nng_null_logger</code>, <a href="api/logging.html#a010">1</a><br/> -<code>NNG_OPT_LISTEN_FD</code>, <a href="api/stream.html#a066">1</a><br/> +<code>NNG_OPT_LISTEN_FD</code>, <a href="api/stream.html#a061">1</a><br/> <code>NNG_OPT_REQ_RESENDTICK</code>, <a href="proto/req.html#a007">1</a><br/> <code>NNG_OPT_REQ_RESENDTIME</code>, <a href="proto/req.html#a006">1</a><br/> <code>NNG_OPT_SOCKET_FD</code>, <a href="tran/socket.html#a002">1</a><br/> @@ -7413,28 +7414,26 @@ named pipes, <a href="tran/ipc.html#a004">1</a><br/> <code>nng_strdup</code>, <a href="api/memory.html#a005">1</a><br/> <code>nng_stream</code>, <a href="api/stream.html#a002">1</a><br/> <code>nng_stream_close</code>, <a href="api/stream.html#a005">1</a><br/> -<code>nng_stream_dialer_alloc</code>, <a href="api/stream.html#a023">1</a><br/> -<code>nng_stream_dialer_alloc_url</code>, <a href="api/stream.html#a024">1</a><br/> -<code>nng_stream_dialer_close</code>, <a href="api/stream.html#a028">1</a><br/> -<code>nng_stream_dialer_dial</code>, <a href="api/stream.html#a034">1</a><br/> -<code>nng_stream_dialer_free</code>, <a href="api/stream.html#a032">1</a><br/> -<code>nng_stream_dialer_get_addr</code>, <a href="api/stream.html#a041">1</a><br/> -<code>nng_stream_dialer_get_bool</code>, <a href="api/stream.html#a037">1</a><br/> -<code>nng_stream_dialer_get_int</code>, <a href="api/stream.html#a038">1</a><br/> -<code>nng_stream_dialer_get_ms</code>, <a href="api/stream.html#a039">1</a><br/> -<code>nng_stream_dialer_get_size</code>, <a href="api/stream.html#a040">1</a><br/> -<code>nng_stream_dialer_get_string</code>, <a href="api/stream.html#a042">1</a><br/> -<code>nng_stream_dialer_get_tls</code>, <a href="api/stream.html#a070">1</a><br/> -<code>nng_stream_dialer_get_uint64</code>, <a href="api/stream.html#a043">1</a><br/> -<code>nng_stream_dialer_set_addr</code>, <a href="api/stream.html#a048">1</a><br/> -<code>nng_stream_dialer_set_bool</code>, <a href="api/stream.html#a044">1</a><br/> -<code>nng_stream_dialer_set_int</code>, <a href="api/stream.html#a045">1</a><br/> -<code>nng_stream_dialer_set_ms</code>, <a href="api/stream.html#a046">1</a><br/> -<code>nng_stream_dialer_set_size</code>, <a href="api/stream.html#a047">1</a><br/> -<code>nng_stream_dialer_set_string</code>, <a href="api/stream.html#a049">1</a><br/> -<code>nng_stream_dialer_set_tls</code>, <a href="api/stream.html#a068">1</a><br/> -<code>nng_stream_dialer_set_uint64</code>, <a href="api/stream.html#a050">1</a><br/> -<code>nng_stream_dialer_stop</code>, <a href="api/stream.html#a030">1</a><br/> +<code>nng_stream_dialer_alloc</code>, <a href="api/stream.html#a022">1</a><br/> +<code>nng_stream_dialer_alloc_url</code>, <a href="api/stream.html#a023">1</a><br/> +<code>nng_stream_dialer_close</code>, <a href="api/stream.html#a027">1</a><br/> +<code>nng_stream_dialer_dial</code>, <a href="api/stream.html#a033">1</a><br/> +<code>nng_stream_dialer_free</code>, <a href="api/stream.html#a031">1</a><br/> +<code>nng_stream_dialer_get_addr</code>, <a href="api/stream.html#a040">1</a><br/> +<code>nng_stream_dialer_get_bool</code>, <a href="api/stream.html#a036">1</a><br/> +<code>nng_stream_dialer_get_int</code>, <a href="api/stream.html#a037">1</a><br/> +<code>nng_stream_dialer_get_ms</code>, <a href="api/stream.html#a038">1</a><br/> +<code>nng_stream_dialer_get_size</code>, <a href="api/stream.html#a039">1</a><br/> +<code>nng_stream_dialer_get_string</code>, <a href="api/stream.html#a041">1</a><br/> +<code>nng_stream_dialer_get_tls</code>, <a href="api/stream.html#a065">1</a><br/> +<code>nng_stream_dialer_set_addr</code>, <a href="api/stream.html#a046">1</a><br/> +<code>nng_stream_dialer_set_bool</code>, <a href="api/stream.html#a042">1</a><br/> +<code>nng_stream_dialer_set_int</code>, <a href="api/stream.html#a043">1</a><br/> +<code>nng_stream_dialer_set_ms</code>, <a href="api/stream.html#a044">1</a><br/> +<code>nng_stream_dialer_set_size</code>, <a href="api/stream.html#a045">1</a><br/> +<code>nng_stream_dialer_set_string</code>, <a href="api/stream.html#a047">1</a><br/> +<code>nng_stream_dialer_set_tls</code>, <a href="api/stream.html#a063">1</a><br/> +<code>nng_stream_dialer_stop</code>, <a href="api/stream.html#a029">1</a><br/> <code>nng_stream_free</code>, <a href="api/stream.html#a007">1</a><br/> <code>nng_stream_get_addr</code>, <a href="api/stream.html#a012">1</a><br/> <code>nng_stream_get_bool</code>, <a href="api/stream.html#a008">1</a><br/> @@ -7442,31 +7441,28 @@ named pipes, <a href="tran/ipc.html#a004">1</a><br/> <code>nng_stream_get_ms</code>, <a href="api/stream.html#a010">1</a><br/> <code>nng_stream_get_size</code>, <a href="api/stream.html#a011">1</a><br/> <code>nng_stream_get_string</code>, <a href="api/stream.html#a013">1</a><br/> -<code>nng_stream_get_uint64</code>, <a href="api/stream.html#a014">1</a><br/> -<code>nng_stream_listener</code>, <a href="api/stream.html#a016">1</a>, <a href="api/stream.html#a017">2</a><br/> -<code>nng_stream_listener_accept</code>, <a href="api/stream.html#a036">1</a><br/> -<code>nng_stream_listener_alloc</code>, <a href="api/stream.html#a026">1</a><br/> -<code>nng_stream_listener_alloc_url</code>, <a href="api/stream.html#a027">1</a><br/> -<code>nng_stream_listener_close</code>, <a href="api/stream.html#a029">1</a><br/> -<code>nng_stream_listener_free</code>, <a href="api/stream.html#a033">1</a><br/> -<code>nng_stream_listener_get_addr</code>, <a href="api/stream.html#a055">1</a><br/> -<code>nng_stream_listener_get_bool</code>, <a href="api/stream.html#a051">1</a><br/> -<code>nng_stream_listener_get_int</code>, <a href="api/stream.html#a052">1</a><br/> -<code>nng_stream_listener_get_ms</code>, <a href="api/stream.html#a053">1</a><br/> -<code>nng_stream_listener_get_size</code>, <a href="api/stream.html#a054">1</a><br/> -<code>nng_stream_listener_get_string</code>, <a href="api/stream.html#a056">1</a><br/> -<code>nng_stream_listener_get_tls</code>, <a href="api/stream.html#a071">1</a><br/> -<code>nng_stream_listener_get_uint64</code>, <a href="api/stream.html#a057">1</a><br/> -<code>nng_stream_listener_listen</code>, <a href="api/stream.html#a035">1</a><br/> -<code>nng_stream_listener_set_addr</code>, <a href="api/stream.html#a062">1</a><br/> -<code>nng_stream_listener_set_bool</code>, <a href="api/stream.html#a058">1</a><br/> -<code>nng_stream_listener_set_int</code>, <a href="api/stream.html#a059">1</a><br/> -<code>nng_stream_listener_set_ms</code>, <a href="api/stream.html#a060">1</a><br/> -<code>nng_stream_listener_set_size</code>, <a href="api/stream.html#a061">1</a><br/> -<code>nng_stream_listener_set_string</code>, <a href="api/stream.html#a063">1</a><br/> -<code>nng_stream_listener_set_tls</code>, <a href="api/stream.html#a069">1</a><br/> -<code>nng_stream_listener_set_uint64</code>, <a href="api/stream.html#a064">1</a><br/> -<code>nng_stream_listener_stop</code>, <a href="api/stream.html#a031">1</a><br/> +<code>nng_stream_listener</code>, <a href="api/stream.html#a015">1</a>, <a href="api/stream.html#a016">2</a><br/> +<code>nng_stream_listener_accept</code>, <a href="api/stream.html#a035">1</a><br/> +<code>nng_stream_listener_alloc</code>, <a href="api/stream.html#a025">1</a><br/> +<code>nng_stream_listener_alloc_url</code>, <a href="api/stream.html#a026">1</a><br/> +<code>nng_stream_listener_close</code>, <a href="api/stream.html#a028">1</a><br/> +<code>nng_stream_listener_free</code>, <a href="api/stream.html#a032">1</a><br/> +<code>nng_stream_listener_get_addr</code>, <a href="api/stream.html#a052">1</a><br/> +<code>nng_stream_listener_get_bool</code>, <a href="api/stream.html#a048">1</a><br/> +<code>nng_stream_listener_get_int</code>, <a href="api/stream.html#a049">1</a><br/> +<code>nng_stream_listener_get_ms</code>, <a href="api/stream.html#a050">1</a><br/> +<code>nng_stream_listener_get_size</code>, <a href="api/stream.html#a051">1</a><br/> +<code>nng_stream_listener_get_string</code>, <a href="api/stream.html#a053">1</a><br/> +<code>nng_stream_listener_get_tls</code>, <a href="api/stream.html#a066">1</a><br/> +<code>nng_stream_listener_listen</code>, <a href="api/stream.html#a034">1</a><br/> +<code>nng_stream_listener_set_addr</code>, <a href="api/stream.html#a058">1</a><br/> +<code>nng_stream_listener_set_bool</code>, <a href="api/stream.html#a054">1</a><br/> +<code>nng_stream_listener_set_int</code>, <a href="api/stream.html#a055">1</a><br/> +<code>nng_stream_listener_set_ms</code>, <a href="api/stream.html#a056">1</a><br/> +<code>nng_stream_listener_set_size</code>, <a href="api/stream.html#a057">1</a><br/> +<code>nng_stream_listener_set_string</code>, <a href="api/stream.html#a059">1</a><br/> +<code>nng_stream_listener_set_tls</code>, <a href="api/stream.html#a064">1</a><br/> +<code>nng_stream_listener_stop</code>, <a href="api/stream.html#a030">1</a><br/> <code>nng_stream_recv</code>, <a href="api/stream.html#a004">1</a><br/> <code>nng_stream_send</code>, <a href="api/stream.html#a003">1</a><br/> <code>nng_stream_stop</code>, <a href="api/stream.html#a006">1</a><br/> @@ -7525,14 +7521,14 @@ request/reply pattern, <a href="proto/rep.html#a003">1</a>, <a href="proto/req.h scatter, <a href="api/aio.html#a023">1</a><br/> scheduling, <a href="api/time.html#a010">1</a><br/> service discovery, <a href="proto/surveyor.html#a006">1</a><br/> -<code>socket</code>, <a href="api/stream.html#a021">1</a><br/> +<code>socket</code>, <a href="api/stream.html#a020">1</a><br/> socket, <a href="api/sock.html#a001">1</a><br/> -socket activation, <a href="api/stream.html#a065">1</a><br/> +socket activation, <a href="api/stream.html#a060">1</a><br/> <em>socket</em> transport, <a href="tran/socket.html#a001">1</a><br/> <code>socket://</code>, <a href="tran/socket.html#a003">1</a><br/> state machines, <a href="api/ctx.html#a003">1</a><br/> statistics, <a href="api/stats.html#a001">1</a><br/> -stream factory, <a href="api/stream.html#a015">1</a><br/> +stream factory, <a href="api/stream.html#a014">1</a><br/> streams, <a href="api/stream.html#a001">1</a><br/> <em>SUB</em>, <a href="proto/sub.html#a002">1</a><br/> <em>SUB</em> protocol, <a href="proto/sub.html#a001">1</a><br/> @@ -7544,14 +7540,14 @@ synchronization primitives, <a href="api/synch.html#a001">1</a><br/> threads, <a href="api/thread.html#a001">1</a><br/> thundering herd, <a href="api/synch.html#a016">1</a><br/> timeout, <a href="api/aio.html#a012">1</a><br/> -TLS, <a href="api/stream.html#a067">1</a><br/> +TLS, <a href="api/stream.html#a062">1</a><br/> UDP, <a href="tran/udp.html#a002">1</a><br/> <em>udp</em> transport, <a href="tran/udp.html#a001">1</a><br/> <code>udp://</code>, <a href="tran/udp.html#a005">1</a><br/> Universal Resource Locator, <a href="api/url.html#a001">1</a><br/> UNIX domain sockets, <a href="tran/ipc.html#a003">1</a><br/> <code>unix://</code>, <a href="tran/ipc.html#a006">1</a><br/> -URL, <a href="api/url.html#a002">1</a>, <a href="api/stream.html#a025">2</a><br/> +URL, <a href="api/url.html#a002">1</a>, <a href="api/stream.html#a024">2</a><br/> version number, <a href="api/misc.html#a005">1</a><br/> voting, <a href="proto/surveyor.html#a004">1</a><br/></p> |