Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

cgi(5) [debian man page]

cgi(5)								Programmer's Manual							    cgi(5)

NAME
cgi - Common Gateway Interface DESCRIPTION
The Common Gateway Interface is a way to create dynamic web pages. It defines rules for interaction between a program and the web server while the server talks to the client. There are some ways to use it. ENVIRONMENT
Normally the webserver sets several environment variables to give some information to the CGI program so it can determine various stuff. AUTH_TYPE This reflects the authentification method used to validate a user. CONTENT_LENGTH The length of the data in bytes passed to the CGI program through standard input. This is used by the POST method. CONTENT_TYPE The MIME type of the query data, such as "text/html", optional. DOCUMENT_ROOT This reflects the document root directory of the webserver. GATEWAY_INTERFACE Reflects the version of the Common Gateway Interface that the server is using HTTP_ACCEPT A comma separated list of MIME type that the client is willing to accept. HTTP_FROM The email address of the user issuing the information request. This is not supported by most browsers. HTTP_REFERER Reflects the URL from which this CGI program was accessed. HTTP_USER_AGENT The name, version and libraries of the browser making the request. This information can be used to determine if the browser is capable of graphics and is able to display frames and tables. PATH_INFO This shows extra information that was passed to the CGI program via command line. Normally it's empty or non-existent. PATH_TRANSLATED The translated path on the local filesystem. QUERY_STRING This variable refers to additional arguments that were appended to the CGI program - normally with the '?' sign. REMOTE_ADDR This refers to the host from which the information request was issued, as IP number. REMOTE_HOST This refers to the host from which the information request was issued. REMOTE_USER The authenticated name of the user. REQUEST_METHOD This refers to the method with which the information request was issued. Normally this is either GET or POST. SCRIPT_NAME The virtual name of the script being executed. SERVER_NAME The server's hostname or IP number. This may be used to determine the correct paths or resulting HTML code for CGI programs that are used on the same machine for several servers. SERVER_PROTOCOL This is the name and version of the information protocol the request came in with. Normally this is "HTTP/1.0" or "HTTP/1.1". SERVER_PORT This refers to the TCP/IP port on which the webserver is running. SERVER_SOFTWARE This reflects the name and revision of the webserver software. 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), cgiHeader(3), cgiSetType(3), cgiSetHeader(3), cgiGetValue(3), cgiGetVariables(3). CGI Library 6 April 2008 cgi(5)

Check Out this Related Man Page

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