summaryrefslogtreecommitdiff
path: root/docs/manual/mod/mod_include.xml
diff options
context:
space:
mode:
authorGraham Leggett <minfrin@apache.org>2007-11-07 23:31:03 +0000
committerGraham Leggett <minfrin@apache.org>2007-11-07 23:31:03 +0000
commita6d30e317ae333026fa4c7bf260bc21d0fa26495 (patch)
treebf2df8a4cc022831a193bb9e9eb29835a9ee3524 /docs/manual/mod/mod_include.xml
parent30ede8a9cdbfa97731759ce38f70ef6b8b9c96a0 (diff)
downloadhttpd-a6d30e317ae333026fa4c7bf260bc21d0fa26495.tar.gz
core: Add the option to keep aside a request body up to a certain
size that would otherwise be discarded, to be consumed by filters such as mod_include. When enabled for a directory, POST requests to shtml files can be passed through to embedded scripts as POST requests, rather being downgraded to GET requests. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@592951 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mod_include.xml')
-rw-r--r--docs/manual/mod/mod_include.xml12
1 files changed, 10 insertions, 2 deletions
diff --git a/docs/manual/mod/mod_include.xml b/docs/manual/mod/mod_include.xml
index 851db2eb40..c526416e3c 100644
--- a/docs/manual/mod/mod_include.xml
+++ b/docs/manual/mod/mod_include.xml
@@ -343,14 +343,22 @@
<p>If the specified URL is a CGI program, the program will be
executed and its output inserted in place of the directive in the
parsed file. You may include a query string in a CGI url:</p>
-
+
<example>
&lt;!--#include virtual="/cgi-bin/example.cgi?argument=value" --&gt;
</example>
-
+
<p><code>include virtual</code> should be used in preference
to <code>exec cgi</code> to include the output of CGI programs
into an HTML document.</p>
+
+ <p>If the <directive module="core">KeptBodySize</directive>
+ directive is correctly configured and valid for this included
+ file, attempts to POST requests to the enclosing HTML document
+ will be passed through to subrequests as POST requests as well.
+ Without the directive, all subrequests are processed as GET
+ requests.</p>
+
</dd>
</dl>
</section> <!-- /include -->