You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by co...@apache.org on 2002/01/11 21:36:30 UTC
cvs commit: httpd-docs-1.3/htdocs/manual/mod core.html.en directives.html.en
coar 02/01/11 12:36:30
Modified: htdocs/manual/mod core.html.en directives.html.en
Log:
Document the FileETag directive
Revision Changes Path
1.205 +59 -0 httpd-docs-1.3/htdocs/manual/mod/core.html.en
Index: core.html.en
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/core.html.en,v
retrieving revision 1.204
retrieving revision 1.205
diff -u -u -r1.204 -r1.205
--- core.html.en 31 Dec 2001 02:16:27 -0000 1.204
+++ core.html.en 11 Jan 2002 20:36:30 -0000 1.205
@@ -70,6 +70,8 @@
<li><a href="#files"><Files></a></li>
+ <li><a href="#fileetag"><FileETag></a></li>
+
<li><a href="#filesmatch"><FilesMatch></a></li>
<li><a href="#group">Group</a></li>
@@ -1224,6 +1226,63 @@
<p><strong>See also:</strong> <a href="#loglevel">LogLevel</a>
and <a href="../logs.html">Apache Log Files</a></p>
+ <hr />
+
+ <h2><a id="fileetag" name="fileetag"><FileETag> directive</a></h2>
+ <a href="directive-dict.html#Syntax"
+ rel="Help"><strong>Syntax:</strong></a> FileETag
+ <i>component</i> ...<br />
+ <a href="directive-dict.html#Context"
+ rel="Help"><strong>Context:</strong></a> server config, virtual
+ host, .htaccess<br />
+ <a href="directive-dict.html#Override"
+ rel="Help"><strong>Override:</strong></a> FileInfo<br />
+ <a href="directive-dict.html#Status"
+ rel="Help"><strong>Status:</strong></a> core<br />
+ <a href="directive-dict.html#Compatibility"
+ rel="Help"><strong>Compatibility:</strong></a> only available
+ in Apache 1.3.23 versions and later.
+
+ <p>
+ The FileETag directive configures the file attributes that are
+ used to create the ETag (entity tag) response header field
+ when the document is based on a file.
+ (The ETag value is used in cache management to save network
+ bandwidth.) In Apache 1.3.22 and earlier, the ETag value was
+ <i>always</i> formed from the file's inode, size, and last-modified
+ time (mtime). The FileETag directive allows you to choose
+ which of these -- if any -- should be used. The recognised
+ keywords are:
+ </p>
+ <dl compact="compact">
+ <dt><b>INode</b></dt>
+ <dd>The file's i-node number will be included in the calculation</dd>
+ <dt><b>MTime</b></dt>
+ <dd>The date and time the file was last modified will be included</dd>
+ <dt><b>Size</b></dt>
+ <dd>The number of bytes in the file will be included</dd>
+ <dt><b>All</b></dt>
+ <dd>All available fields will be used (equivalent to
+ '<code>FileETag INode MTime Size</code>')</dd>
+ <dt><b>None</b></dt>
+ <dd>If a document is file-based, no ETag field will be included in the
+ response</dd>
+ </dl>
+ <p>
+ The INode, MTime, and Size keywords may be prefixed with either '+'
+ or '-', which allow changes to be made to the default setting
+ inherited from a broader scope. Any keyword appearing without
+ such a prefix immediatey and completely cancels the inherited
+ setting.
+ </p>
+ <p>
+ If a directory's configuration includes
+ '<code>FileETag INode MTime Size</code>', and a
+ subdirectory's includes '<code>FileETag -INode</code>',
+ the setting for that subdirectory (which will be inherited by
+ any sub-subdirectories that don't override it) will be equivalent to
+ '<code>FileETag MTime Size</code>'.
+ </p>
<hr />
<h2><a id="files" name="files"><Files> directive</a></h2>
1.73 +2 -0 httpd-docs-1.3/htdocs/manual/mod/directives.html.en
Index: directives.html.en
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/directives.html.en,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -u -r1.72 -r1.73
--- directives.html.en 31 Dec 2001 02:16:27 -0000 1.72
+++ directives.html.en 11 Jan 2002 20:36:30 -0000 1.73
@@ -249,6 +249,8 @@
<li><a
href="mod_autoindex.html#fancyindexing">FancyIndexing</a></li>
+ <li><a href="core.html#fileetag">FileETag</a></li>
+
<li><a href="core.html#files"><Files></a></li>
<li><a