cache in the event that the client cancels the transfer, provided that

the configured percentage of the file has already been transfered.
It works for http transfers only.

The new httpd.conf directive is:
CacheForceCompletion <percentage>

PR: 2277
Submitted by: 	Glen Parker <glenebob@nwlink.com>
Reviewed by:	Martin Kraemer, Brian Behlendorf

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@81685 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html
index a5a19944c5200f6d03b45a7b44849b0f241c42c6..bdb0a48b25a4b2a373fbff8bcaeda45ce70f5ff4 100644 (file)
--- a/docs/manual/mod/directives.html
+++ b/docs/manual/mod/directives.html
@@ -71,6 +71,7 @@ of the terms used in their descriptions available.
 <LI><A HREF="mod_proxy.html#cachedefaultexpire">CacheDefaultExpire</A>
 <LI><A HREF="mod_proxy.html#cachedirlength">CacheDirLength</A>
 <LI><A HREF="mod_proxy.html#cachedirlevels">CacheDirLevels</A>
+<LI><A HREF="mod_proxy.html#cacheforcecompletion">CacheForceCompletion</A>
 <LI><A HREF="mod_proxy.html#cachegcinterval">CacheGcInterval</A>
 <LI><A HREF="mod_proxy.html#cachelastmodifiedfactor">CacheLastModifiedFactor</A>
 <LI><A HREF="mod_proxy.html#cachemaxexpire">CacheMaxExpire</A>

diff --git a/docs/manual/mod/mod_proxy.html b/docs/manual/mod/mod_proxy.html
index b2de7fe5ca34ca4367ab2d2f881ae0956a38a90f..a7fa9f08e048566d11b08374a018a340b321276a 100644 (file)
--- a/docs/manual/mod/mod_proxy.html
+++ b/docs/manual/mod/mod_proxy.html
@@ -56,6 +56,7 @@ and other protocols.
 <LI><A HREF="#cachegcinterval">CacheGcInterval</A>
 <LI><A HREF="#cachedirlevels">CacheDirLevels</A>
 <LI><A HREF="#cachedirlength">CacheDirLength</A>
+<LI><A HREF="#cacheforcecompletion">CacheForceCompletion</A>
 <LI><A HREF="#nocache">NoCache</A>
 </UL>
 
@@ -551,6 +552,47 @@ Example:
 
 <HR>
 
+<H2><A NAME="cacheforcecompletion">CacheForceCompletion</A></H2>
+<A
+ HREF="directive-dict.html#Syntax"
+ REL="Help"
+><STRONG>Syntax:</STRONG></A> CacheForceCompletion <EM><percentage></EM><BR>
+<A
+ HREF="directive-dict.html#Default"
+ REL="Help"
+><STRONG>Default:</STRONG></A> <EM>90</EM><BR>
+<A
+ HREF="directive-dict.html#Context"
+ REL="Help"
+><STRONG>Context:</STRONG></A> server config, virtual host<BR>
+<A
+ HREF="directive-dict.html#Override"
+ REL="Help"
+><STRONG>Override:</STRONG></A> <EM>Not applicable</EM><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_proxy<BR>
+<A
+ HREF="directive-dict.html#Compatibility"
+ REL="Help"
+><STRONG>Compatibility:</STRONG></A> CacheForceCompletion is only available in
+Apache 1.3 and later.<P>
+
+If an http transfer that is being cached is cancelled, the proxy module will
+complete the transfer to cache if more than the percentage specified has
+already been transferred.<P>
+
+This is a percentage, and must be a number between 1 and 100, or 0 to use
+the default.  100 will cause a document to be cached only if the transfer
+was allowed to complete.  A number between 60 and 90 is recommended.
+
+<HR>
+
 <H2><A NAME="cacheroot">CacheRoot</A></H2>
 <A
  HREF="directive-dict.html#Syntax"