Update transformations.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1004483 13f79535-47bb-0310-9956-ffa450edef68
2026-01-06 09:01:14 +03:00 · 2010-10-04 23:49:26 +00:00
parent 0509b44525
commit b4d6ae84bd
4 changed files with 97 additions and 3 deletions
--- a/docs/man/htcacheclean.8
+++ b/docs/man/htcacheclean.8
@@ -19,7 +19,7 @@
 .el .ne 3
 .IP "\\$1" \\$2
 ..
-.TH "HTCACHECLEAN" 8 "2010-09-29" "Apache HTTP Server" "htcacheclean"
+.TH "HTCACHECLEAN" 8 "2010-10-04" "Apache HTTP Server" "htcacheclean"

 .SH NAME
 htcacheclean \- Clean up the disk cache
@@ -32,6 +32,9 @@ htcacheclean \- Clean up the disk cache
 .PP
 \fBhtcacheclean\fR [ -\fBn\fR ] [ -\fBt\fR ] [ -\fBi\fR ] [ -\fBP\fR\fIpidfile\fR ] [ -\fBR\fR\fIround\fR ] -\fBd\fR\fIinterval\fR -\fBp\fR\fIpath\fR -\fBl\fR\fIlimit\fR
 
+.PP
+\fBhtcacheclean\fR [ -\fBv\fR ] [ -\fBR\fR\fIround\fR ] -\fBp\fR\fIpath\fR [ -\fBa\fR ] [ -\fBA\fR ]
+ 
 .PP
 \fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBt\fR ] [ -\fBR\fR\fIround\fR ] -\fBp\fR\fIpath\fR \fIurl\fR
 
@@ -78,6 +81,12 @@ Specify \fIlimit\fR as the total disk cache size limit\&. The value is expressed
 .TP
 -i
 Be intelligent and run only when there was a modification of the disk cache\&. This option is only possible together with the -d option\&.  
+.TP
+-a
+List the URLs currently stored in the cache\&. Variants of the same URL will be listed once for each variant\&.  
+.TP
+-A
+List the URLs currently stored in the cache, along with their attributes in the following order: url, header size, body size, status, entity version, date, expiry, request time, response time, body present, head request\&.  
 
 .SH "DELETING A SPECIFIC URL"
 
@@ -87,6 +96,46 @@ If htcacheclean is passed one or more URLs, each URL will be deleted from the ca
 .PP
 When a reverse proxied URL is to be deleted, the effective URL is constructed from the \fBHost\fR header, the \fBport\fR, the \fBpath\fR and the \fBquery\fR\&. Note the '?' in the URL must always be specified explicitly, whether a query string is present or not\&. For example, an attempt to delete the path \fB/\fR from the server \fBlocalhost\fR, the URL to delete would be \fBhttp://localhost:80/?\fR\&.
 
+.SH "LISTING URLS IN THE CACHE"
+ 
+.PP
+By passing the -a or -A options to htcacheclean, the URLs within the cache will be listed as they are found, one URL per line\&. The -A option dumps the full cache entry after the URL, with fields in the following order:
+ 
+ 
+.TP
+url
+The URL of the entry\&. 
+.TP
+header size
+The size of the header in bytes\&. 
+.TP
+body size
+The size of the body in bytes\&. 
+.TP
+status
+Status of the cached response\&. 
+.TP
+entity version
+The number of times this entry has been revalidated without being deleted\&. 
+.TP
+date
+Date of the response\&. 
+.TP
+expiry
+Expiry date of the response\&. 
+.TP
+request time
+Time of the start of the request\&. 
+.TP
+response time
+Time of the end of the request\&. 
+.TP
+body present
+If 0, no body is stored with this request, 1 otherwise\&. 
+.TP
+head request
+If 1, the entry contains a cached HEAD request with no body, 0 otherwise\&. 
+ 
 .SH "EXIT STATUS"
 
 .PP
--- a/docs/manual/mod/mod_cache.xml.ja
+++ b/docs/manual/mod/mod_cache.xml.ja
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 504183:1003882 (outdated) -->
+<!-- English Revision: 504183:1003963 (outdated) -->

 <!--
 Licensed to the Apache Software Foundation (ASF) under one or more
--- a/docs/manual/mod/mod_cache.xml.ko
+++ b/docs/manual/mod/mod_cache.xml.ko
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="EUC-KR" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
-<!-- English Revision: 105569:1003882 (outdated) -->
+<!-- English Revision: 105569:1003963 (outdated) -->

 <!--
 Licensed to the Apache Software Foundation (ASF) under one or more
--- a/docs/manual/programs/htcacheclean.html.en
+++ b/docs/manual/programs/htcacheclean.html.en
@@ -36,6 +36,7 @@
 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#delete">Deleting a specific URL</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#list">Listing URLs in the Cache</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#exit">Exit Status</a></li>
 </ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code></li></ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -61,6 +62,13 @@
    -<strong>p</strong><var>path</var>
    -<strong>l</strong><var>limit</var></code></p>

+    <p><code><strong>htcacheclean</strong>
+    [ -<strong>v</strong> ]
+    [ -<strong>R</strong><var>round</var> ]
+    -<strong>p</strong><var>path</var>
+    [ -<strong>a</strong> ]
+    [ -<strong>A</strong> ]</code></p>
+
    <p><code><strong>htcacheclean</strong>
    [ -<strong>D</strong> ]
    [ -<strong>v</strong> ]
@@ -129,7 +137,18 @@
    <dd>Be intelligent and run only when there was a modification of the disk
    cache. This option is only possible together with the <code>-d</code>
    option.</dd>
+
+    <dt><code>-a</code></dt>
+    <dd>List the URLs currently stored in the cache. Variants of the same URL
+    will be listed once for each variant.</dd>
+
+    <dt><code>-A</code></dt>
+    <dd>List the URLs currently stored in the cache, along with their
+    attributes in the following order: url, header size, body size, status,
+    entity version, date, expiry, request time, response time, body present,
+    head request.</dd>
    </dl>
+
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="delete" id="delete">Deleting a specific URL</a></h2>
@@ -146,6 +165,32 @@
    <strong>localhost</strong>, the URL to delete would be
    <strong>http://localhost:80/?</strong>.</p>

+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="list" id="list">Listing URLs in the Cache</a></h2>
+    <p>By passing the <code>-a</code> or <code>-A</code> options to
+    <code>htcacheclean</code>, the URLs within the cache will be listed
+    as they are found, one URL per line. The <code>-A</code> option
+    dumps the full cache entry after the URL, with fields in the
+    following order:</p>
+
+    <dl>
+        <dt>url</dt><dd>The URL of the entry.</dd>
+        <dt>header size</dt><dd>The size of the header in bytes.</dd>
+        <dt>body size</dt><dd>The size of the body in bytes.</dd>
+        <dt>status</dt><dd>Status of the cached response.</dd>
+        <dt>entity version</dt><dd>The number of times this entry has been
+        revalidated without being deleted.</dd>
+        <dt>date</dt><dd>Date of the response.</dd>
+        <dt>expiry</dt><dd>Expiry date of the response.</dd>
+        <dt>request time</dt><dd>Time of the start of the request.</dd>
+        <dt>response time</dt><dd>Time of the end of the request.</dd>
+        <dt>body present</dt><dd>If 0, no body is stored with this request,
+        1 otherwise.</dd>
+        <dt>head request</dt><dd>If 1, the entry contains a cached HEAD
+        request with no body, 0 otherwise.</dd>
+    </dl>
+
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="exit" id="exit">Exit Status</a></h2>