KCGI_REGRESS(3)

NAME
kcgi_regress - automated testing framework for kcgi

LIBRARY
libkcgiregress

SYNOPSIS
#include <kcgiregress.h>
int
kcgi_regress(kcgi_regress_client client, void *client_arg, kcgi_regress_server server, void *server_arg);

DESCRIPTION
The kcgi_regress function is the single function in a library used for automated testing of kcgi(3) systems. It is the mechanism used for internal regression tests as well.

Applications wishing to use this framework provide callback functions to kcgi_regress(), which invokes server with argument server_arg within a CGI environment as if it were spawned by a web server, upon which the usual khttp_parse(3) functions are used to test behaviour. Meanwhile, the client function is invoked for communicating with the server over port 17123. The libcurl(3) library is used for internal testing on the client side.

RETURN VALUES
Both the client and server functions should return zero on test failure. kcgi_regress() returns 0 if any tests or internal machinery fail.

AUTHORS
The kcgihtml library was written by Kristaps Dzonsons <kristaps@bsd.lv>.