KCGI_REGRESS(3) BSD Library Functions Manual KCGI_REGRESS(3)NAMEkcgi_regress — automated testing framework for kcgi
LIBRARY
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⟩.
BSD April 28, 2024 BSD
