NAME

       cgiInit - Initializes CGI library

SYNOPSYS

       #include <cgi.h>

       s_cgi *cgiInit ();

DESCRIPTION

       This routine initializes the CGI routines.  Mainly it reads in and decodes CGI data for later processing.
       If  the program is not called via CGI interface the user is prompted to type in CGI variable bindings via
       stdin - just like CGI.pm does.  There is no limit in the number of variable bindings.

       If HTTP Cookies are used (through the variable HTTP_COOKIE) this routine will  parse  them  as  well  and
       assign them to internal variables.  There is no limit in the number of cookies.

       To  set a cookie you'll have to use the cgiSetHeader(3) routine.  Some clients allow 4kB of Cookies while
       others only allow short ones.  Some clients may also allow only 200 Cookies  for  a  certain  domain/path
       pair.

       This  routine  normally  is the first or second that is called from this library.  Only cgiDebug() may be
       called before.  If debugging is enabled this routine produces some additional output.

       The library supports both the regular GET and POST methods as well as multipart/form-data.

       Memory allocated by this library is freed with the cgiFree(3) function.

RETURN VALUE

       On success a set of CGI variable bindings is returned that is needed for later processing.  If  an  error
       occurs NULL is returned.

AUTHOR

       This CGI library is written by Martin Schulze <joey@infodrom.org>.  If you have additions or improvements
       please get in touch with him.

SEE ALSO

       cgiDebug(3),    cgiSetType(3),    cgiSetHeader(3),   cgiHeader(3),   cgiGetValue(3),   cgiGetVariables(3)
       cgiGetCookie(3), cgiGetCookies(3), cgiFree(3), cgi(5).

CGI Library                                       6 April 2008                                        cgiInit(3)