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_http_server_set_error_file(3http)

NAME

nng_http_server_set_error_file - set custom HTTP error file

SYNOPSIS

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

int nng_http_server_set_error_file(nng_http_server *server,
        uint16_t code, const char *path);

DESCRIPTION

The nng_http_server_set_error_file() sets an error page to be used for HTTP status code on the server instance server. The body content of the HTTP responses will contain the file contents of the file located at path, which should be an HTML file.

The custom HTML content will be used when the server is returning an internally generated error response, or is returning an error response that was allocated with the nng_http_res_alloc_error() function. This HTML content will also be used if the application calls the nng_http_server_res_error(). The last custom error page set for code by either this function or nng_http_server_error_page() will be used.

Error responses that have their body content changed after allocation, or that are written directly by the application, will not use the body content supplied here.
The file contents of path are read when this function is called. Therefore, if the file contents are changed, then this function should be called again to update the error page.

RETURN VALUES

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

ERRORS

NNG_ENOENT

The file named by path does not exist.

NNG_EPERM

No permission to read the file named by path.

NNG_ENOMEM

Insufficient free memory exists.

NNG_ENOTSUP

HTTP not supported.

SEE ALSO