SYNOPSIS
#include <nng/nng.h>
typedef uint32_t nng_pipe;
DESCRIPTION
An nng_pipe
is a handle to a “pipe”, which can be thought of as a single
connection.
(In most cases this is actually the case — the pipe is an abstraction for a
single TCP or IPC connection.)
Pipes are associated with either the listener or dialer that created them,
and therefore are also automatically associated with a single socket.
Most applications should never concern themselves with individual pipes. However it is possible to access a pipe when more information about the source of a message is needed, or when more control is required over message delivery. |
Pipe objects are created by dialers (nng_dialer
objects)
and listeners (nng_listener
objects), which can be
thought of as “owning” the pipe.
Pipe objects may be destroyed by the
nng_pipe_close()
function.
They are also closed when their “owning” dialer or listener is closed,
or when the remote peer closes the underlying connection.