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_close(3)

NAME

nng_listener_close - close listener

SYNOPSIS

#include <nng/nng.h>

int nng_listener_close(nng_listener l);

DESCRIPTION

The nng_listener_close() function closes the listener l. This also closes any pipes that have been created by the listener.

Once this function returns, the listener l and any of its resources are deallocated. Therefore it is an error to attempt to access l after this function has returned. (Attempts to do so will result in NNG_ECLOSED errors.)

Listeners are implicitly closed when the socket they are associated with is closed.

RETURN VALUES

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

ERRORS

NNG_ECLOSED

Parameter l does not refer to an open listener.

SEE ALSO