httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rbo...@apache.org
Subject cvs commit: httpd-docs-1.3/htdocs/manual/mod mod_include.html
Date Sun, 20 Jan 2002 02:41:08 GMT
rbowen      02/01/19 18:41:08

  Modified:    htdocs/manual/mod mod_include.html
  Log:
  Insert a warning about the broken-ness of #exec cmd on Win32, and
  encourage people to use #include virtual instead.
  
  Revision  Changes    Path
  1.37      +20 -2     httpd-docs-1.3/htdocs/manual/mod/mod_include.html
  
  Index: mod_include.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/mod_include.html,v
  retrieving revision 1.36
  retrieving revision 1.37
  diff -u -r1.36 -r1.37
  --- mod_include.html	11 Nov 2001 03:24:01 -0000	1.36
  +++ mod_include.html	20 Jan 2002 02:41:08 -0000	1.37
  @@ -201,9 +201,27 @@
   
             <dt>cmd</dt>
   
  -          <dd>The server will execute the given string using
  +          <dd>
  +          <p>The server will execute the given string using
             <code>/bin/sh</code>. The include variables are available
  -          to the command.</dd>
  +          to the command.</p>
  +
  +        <p>The use of <code>#include virtual</code> is almost always
  +        prefered to using either <code>#exec cgi</code> or <code>#exec
  +        cmd</code>. The former (<code>#include virtual</code>) used the
  +        standard Apache sub-request mechanism to include files or
  +        scripts. It is much better tested and maintained.</p>
  +
  +          <p>In addition, on some platforms, like Win32, and on unix
  +          when using suexec, you cannot pass arguments to a command in 
  +          an <code>exec</code> directive, or otherwise include spaces in
  +          the command. Thus, while the following will work under a
  +          non-suexec configuration on unix, it will not produce the
  +          desired result under Win32, or when running suexec:</p>
  +
  +   <code>&lt;!--#exec cmd="perl /path/to/perlscript arg1 arg2" --&gt;</code>
  +
  +          </dd>
           </dl>
         </dd>
   
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message