table of contents
| NNG_LISTENER_CREATE(3) | NNG Reference Manual | NNG_LISTENER_CREATE(3) |
NAME¶
nng_listener_create - create listener
SYNOPSIS¶
#include <nng/nng.h> int nng_listener_create(nng_listener *listenerp, nng_socket s, const char *url);
DESCRIPTION¶
The nng_listener_create() function creates a newly initialized nng_listener object, associated with socket s, and configured to listen at the address specified by url, and stores a pointer to at the location referenced by listenerp.
Listeners are used to accept connections initiated by remote dialers. An incoming connection generally results in a pipe being created and attached to the socket s. Unlike dialers, listeners generally can create many pipes, which may be open concurrently.
Tip
While it is convenient to think of listeners as servers, the
relationship between the listener or dialer is orthogonal to any server or
client status that might be associated with a given protocol. For example, a
req socket might have associated dialers, but might also have
associated listeners. It may even have some of each at the same time!
The listener is not started, but may be further configured with the nng_listener_setopt() family of functions.
Once it is fully configured, the listener may be started using the nng_listener_start() function.
Tip
If no specific configuration is required, consider using the
simpler nng_listen() function instead.
RETURN VALUES¶
This function returns 0 on success, and non-zero otherwise.
ERRORS¶
NNG_EADDRINVAL
NNG_ECLOSED
NNG_ENOMEM
SEE ALSO¶
nng_dialer_create(3) nng_listen(3), nng_listener_close(3), nng_listener_getopt(3), nng_listener_setopt(3), nng_listener_start(3), nng_strerror(3), nng_listener(5), nng(7)
| 2024-10-11 |