cgiinit(3) [debian man page]

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

AppConfig::CGI(3)					User Contributed Perl Documentation					 AppConfig::CGI(3)

NAME

       AppConfig::CGI - Perl5 module for processing CGI script parameters.

SYNOPSIS

	   use AppConfig::CGI;

	   my $state = AppConfig::State->new(\%cfg);
	   my $cgi   = AppConfig::CGI->new($state);

	   $cgi->parse($cgi_query);
	   $cgi->parse();		# looks for CGI query in environment

OVERVIEW

       AppConfig::CGI is a Perl5 module which implements a CGI interface to AppConfig.	It examines the QUERY_STRING environment variable, or a
       string passed explicitly by parameter, which represents the additional parameters passed to a CGI query.  This is then used to update
       variable values in an AppConfig::State object accordingly.

       AppConfig::CGI is distributed as part of the AppConfig bundle.

DESCRIPTION

   USING THE AppConfig::CGI MODULE
       To import and use the AppConfig::CGI module the following line should appear in your Perl script:

	   use AppConfig::CGI;

       AppConfig::CGI is used automatically if you use the AppConfig module and create an AppConfig::CGI object through the cgi() method.
       AppConfig::CGI is implemented using object-oriented methods.  A new AppConfig::CGI object is created and initialised using the new()
       method.	This returns a reference to a new AppConfig::CGI object.  A reference to an AppConfig::State object should be passed in as the
       first parameter:

	   my $state = AppConfig::State->new();
	   my $cgi   = AppConfig::CGI->new($state);

       This will create and return a reference to a new AppConfig::CGI object.

   PARSING CGI QUERIES
       The "parse()" method is used to parse a CGI query which can be specified explicitly, or is automatically extracted from the "QUERY_STRING"
       CGI environment variable.  This currently limits the module to only supporting the GET method.

       See AppConfig for information about using the AppConfig::CGI module via the cgi() method.

AUTHOR

       Andy Wardley, "<abw@wardley.org<gt">

COPYRIGHT

       Copyright (C) 1997-2007 Andy Wardley.  All Rights Reserved.

       Copyright (C) 1997,1998 Canon Research Centre Europe Ltd.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       AppConfig, AppConfig::State

perl v5.12.1							    2007-05-30							 AppConfig::CGI(3)