KCGIREGRESS(3) BSD Library Functions Manual KCGIREGRESS(3)NAME
kcgiregress, kcgi_regress_cgi, kcgi_regress_fcgi — regression framework
for kcgi
LIBRARY
library “libkcgiregress”
SYNOPSIS
#include <kcgiregress.h>
int
kcgi_regress_cgi(int (*client)(void *), void *clientData,
int (*server)(void *), void *serverData);
int
kcgi_regress_fcgi(int (*client)(void *), void *clientData,
int (*server)(void *), void *serverData);
DESCRIPTION
The kcgi_regress_cgi and kcgi_regress_fcgi functions are used for auto‐
mated testing of kcgi(3) systems, both as CGI and FastCGI scripts. It is
the mechanism used for internal regression tests as well.
Applications wishing to use this framework provide callback functions to
kcgi_regress_cgi() and kcgi_regress_fcgi(), which invoke server with
argument serverArg within a CGI or FastCGI environment as if it were
spawned by a web server, upon which the usual khttp_parse(3) or
khttp_fcgi_init(3) and khttp_fcgi_parse(3) functions are used to test be‐
haviour. 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.
In most applications, the main function invokes kcgi_regress_cgi or
kcgi_regress_fcgi, prepares a libCURL request in the client callback,
then runs the usual kcgi(3) sequence in the server callback.
RETURN VALUES
Both the client and server functions should return zero on test failure.
kcgi_regress_cgi() and kcgi_regress_fcgi() return zero if any tests or
internal machinery fail.
AUTHORS
The kcgiregress library was written by Kristaps Dzonsons
⟨kristaps@bsd.lv⟩.
BSD April 29, 2024 BSD
