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><!--#exec cmd="perl /path/to/perlscript arg1 arg2" --></code>
+
+ </dd>
</dl>
</dd>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
