dwww Home | Manual pages | Find package

cgiInit(3)                    Programmer's Manual                   cgiInit(3)

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 rou-
       tine 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),   cgiGet-
       Value(3),    cgiGetVariables(3)    cgiGetCookie(3),   cgiGetCookies(3),
       cgiFree(3), cgi(5).

CGI Library                      6 April 2008                       cgiInit(3)

Generated by dwww version 1.11.3 on Wed May 22 19:47:02 CEST 2013.