httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sl...@apache.org
Subject cvs commit: httpd-2.0/docs/manual index.html.en
Date Sun, 06 May 2001 05:08:01 GMT
slive       01/05/05 22:08:01

  Modified:    docs/manual/mod index.html index-bytype.html mod_cgi.html
               docs/manual index.html.en
  Added:       docs/manual/mod mod_cgid.html
  Log:
  Update some CGI docs:
  - add docs for mod_cgid
  - link up the CGI tutorial brought forward from 1.3
  
  Revision  Changes    Path
  1.50      +2 -0      httpd-2.0/docs/manual/mod/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/index.html,v
  retrieving revision 1.49
  retrieving revision 1.50
  diff -u -d -b -u -r1.49 -r1.50
  --- index.html	2001/02/16 19:00:00	1.49
  +++ index.html	2001/05/06 05:07:59	1.50
  @@ -70,6 +70,8 @@
   <DD>Support for HTTP header metafiles.
   <DT><A HREF="mod_cgi.html">mod_cgi</A>
   <DD>Invoking CGI scripts.
  +<DT><A HREF="mod_cgid.html">mod_cgid</A>
  +<DD>Invoking CGI scripts using an external daemon.
   <DT><A HREF="mod_charset_lite.html">mod_charset_lite</A>
   <DD>Configuring character set translation.
   <DT><A HREF="mod_dav.html">mod_dav</A>
  
  
  
  1.15      +2 -0      httpd-2.0/docs/manual/mod/index-bytype.html
  
  Index: index-bytype.html
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/index-bytype.html,v
  retrieving revision 1.14
  retrieving revision 1.15
  diff -u -d -b -u -r1.14 -r1.15
  --- index-bytype.html	2001/02/16 18:59:59	1.14
  +++ index-bytype.html	2001/05/06 05:07:59	1.15
  @@ -128,6 +128,8 @@
   <DD>Server-parsed documents.
   <DT><A HREF="mod_cgi.html">mod_cgi</A>
   <DD>Invoking CGI scripts.
  +<DT><A HREF="mod_cgid.html">mod_cgid</A>
  +<DD>Invoking CGI scripts using an external daemon.
   <DT><A HREF="mod_actions.html">mod_actions</A>
   <DD>Executing CGI scripts based on media type or request method.
   <DT><A HREF="mod_isapi.html">mod_isapi</A>
  
  
  
  1.22      +12 -4     httpd-2.0/docs/manual/mod/mod_cgi.html
  
  Index: mod_cgi.html
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_cgi.html,v
  retrieving revision 1.21
  retrieving revision 1.22
  diff -u -d -b -u -r1.21 -r1.22
  --- mod_cgi.html	2000/12/09 19:50:02	1.21
  +++ mod_cgi.html	2001/05/06 05:07:59	1.22
  @@ -39,18 +39,26 @@
   <!-- XXX: Should have references to CGI definition/RFC -->
   <!-- XXX: Should mention Options ExecCGI  -->
   
  -Any file that has the mime type <CODE>application/x-httpd-cgi</CODE>
  +<p>Any file that has the mime type <CODE>application/x-httpd-cgi</CODE>
   or handler <CODE>cgi-script</CODE> (Apache 1.1 or later)
   will be treated as a CGI script, and run by the server, with its output
   being returned to the client. Files acquire this type either by
   having a name containing an extension defined by the
   <A HREF="mod_mime.html#addtype">AddType</A> directive, or by being in
  -a <A HREF="mod_alias.html#scriptalias">ScriptAlias</A> directory. <P>
  +a <A HREF="mod_alias.html#scriptalias">ScriptAlias</A> directory.</P>
   
  -When the server invokes a CGI script, it will add a variable called
  +<p>When the server invokes a CGI script, it will add a variable called
   <CODE>DOCUMENT_ROOT</CODE> to the environment. This variable will contain the
   value of the <A HREF="core.html#documentroot">DocumentRoot</A>
  -configuration variable.
  +configuration variable.</p>
  +
  +<p>For an intruction to using CGI scripts with Apache, see our
  +tutorial on <a href="../howto/cgi.html">Dynamic Content With CGI</a>.</p>
  +
  +<p>When using a multi-threaded MPM under unix, the module <a
  +href="mod_cgid.html">mod_cgid</a> should be used in place of this
  +module.  At the user level, the two modules are essentially
  +identical.</p>
   
   <h2>Directives</h2>
   
  
  
  
  1.1                  httpd-2.0/docs/manual/mod/mod_cgid.html
  
  Index: mod_cgid.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  <HTML>
  <HEAD>
  <TITLE>Apache module mod_cgi</TITLE>
  </HEAD>
  
  <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
  <BODY
   BGCOLOR="#FFFFFF"
   TEXT="#000000"
   LINK="#0000FF"
   VLINK="#000080"
   ALINK="#FF0000"
  >
  <!--#include virtual="header.html" -->
  
  <H1 ALIGN="CENTER">Module mod_cgid</H1>
  
  <p>This module provides for execution of CGI scripts using an external
  CGI daemon.</p>
  
  <P><A
  HREF="module-dict.html#Status"
  REL="Help"
  ><STRONG>Status:</STRONG></A> Base (unix threaded MPMs only)
  <BR>
  <A
  HREF="module-dict.html#SourceFile"
  REL="Help"
  ><STRONG>Source File:</STRONG></A> mod_cgid.c
  <BR>
  <A
  HREF="module-dict.html#ModuleIdentifier"
  REL="Help"
  ><STRONG>Module Identifier:</STRONG></A> cgid_module
  </P>
  
  
  <H2>Summary</H2>
  
  <p>On certain unix operating systems, forking a process from a
  multi-threaded server is a very expensive operation because the new
  process will replicate all the threads of the parent process.  In
  order to avoid incurring this expense on each CGI invocation, mod_cgid
  creates an external daemon that is responsible for forking child
  processes to run CGI scripts.  The main server communicates with this
  daemon using a unix domain socket.</p>
  
  <p>This module is used by default whenever a multi-threaded MPM is
  selected during the compilation process.  At the user level, this
  module is identical in configuration and operation to <a
  href="mod_cgi.html">mod_cgi</a>.  The only exception is the additional
  directive <code>ScriptSock</code> which gives the name of the socket
  to use for communication with the cgi daemon.</p>
  
  <h2>Directives</h2>
  
  <ul>
  <li><a href="mod_cgi.html#scriptlog">ScriptLog</a></li>
  <li><a href="mod_cgi.html#scriptloglength">ScriptLogLength</a></li>
  <li><a href="mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></li>
  <li><a href="#scriptsock">ScriptSock</a></li>
  </ul>
  
  <hr>
  
  <H3><A NAME="scriptsock">ScriptSock</A> directive</H3>
  
  <p><A
   HREF="directive-dict.html#Syntax"
   REL="Help"
  ><STRONG>Syntax:</STRONG></A> Scriptsock <EM>filename</EM><BR>
  <A
   HREF="directive-dict.html#Default"
   REL="Help"
  ><STRONG>Default:</STRONG></A> logs/cgisock<BR>
  <A
   HREF="directive-dict.html#Context"
   REL="Help"
  ><STRONG>Context:</STRONG></A> server config<BR>
  <A
   HREF="directive-dict.html#Status"
   REL="Help"
  ><STRONG>Status:</STRONG></A> Base<br>
  <A
   HREF="directive-dict.html#Module"
   REL="Help"
  ><STRONG>Module:</STRONG></A> mod_cgid</p>
  
  <p>This directive sets the name of the socket to use for communication
  with the CGI daemon.  The socket will be opened using the permissions
  of the user who starts Apache (usually root).  To maintain the security
  of communications with CGI scripts, it is important that no other
  user has permission to write in the directory where the socket is
  located.</p>
  
  
  <!--#include virtual="footer.html" -->
  </BODY>
  </HTML>
  
  
  
  
  1.22      +2 -0      httpd-2.0/docs/manual/index.html.en
  
  Index: index.html.en
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/index.html.en,v
  retrieving revision 1.21
  retrieving revision 1.22
  diff -u -d -b -u -r1.21 -r1.22
  --- index.html.en	2001/02/23 05:06:10	1.21
  +++ index.html.en	2001/05/06 05:08:01	1.22
  @@ -133,6 +133,8 @@
   </td></tr><tr><td>
   <A HREF="vhosts/">Virtual Hosts</A>
   </td></tr><tr><td>
  +<A HREF="howto/cgi.html">Dynamic Content with CGI</A>
  +</td></tr><tr><td>
   <A HREF="handler.html">Handlers</A>
   </td></tr><tr><td>
   <A HREF="filter.html">Filters</A>
  
  
  

Mime
View raw message