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).