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.8.0. See the documentation for v1.8.0 for the most up-to-date information.

nng_http_server_stop(3http)

NAME

nng_http_server_stop - stop HTTP server

SYNOPSIS

#include <nng/nng.h>
#include <nng/supplemental/http/http.h>

void nng_http_server_stop(nng_http_server *server);

DESCRIPTION

The nng_http_server_stop() undoes the effect of nng_http_server_start().

Each call by nng_http_server_start() acts as reference count, and should be matched by a call to nng_http_server_stop(). When the reference count drops to zero, then the server is actually stopped, and existing open connections to it are closed.

This function does not wait for the connections to close.

Once the server instance is actually stopped, it cannot be started again, and any future calls to nng_http_server_hold() will return a new instance of the server. It is expected that the caller will follow this function call with a call to nng_http_server_release().

RETURN VALUES

None.

ERRORS