This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.3.2. See the documentation for v1.3.2 for the most up-to-date information.

nng_listener_start(3)

NAME

nng_listener_start - start listener

SYNOPSIS

#include <nng/nng.h>

int nng_listener_start(nng_listener l, int flags);

DESCRIPTION

The nng_listener_start() function starts the listener l.

This causes the listener to bind to the address it was created with, and to start accepting connections from remote dialers. Each new connection results in an nng_pipe object, which will be attached to the listener’s socket.

The flags argument is ignored, but reserved for future use.

Once a listener has started, it is generally not possible to change its configuration.

RETURN VALUES

This function returns 0 on success, and non-zero otherwise.

ERRORS

NNG_ECLOSED

Parameter l does not refer to an open listener.

NNG_ESTATE

The listener l is already started.

SEE ALSO