add generated manpage for htcacheclean(8)

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

diff --git a/docs/man/htcacheclean.8 b/docs/man/htcacheclean.8
new file mode 100644 (file)
index 0000000..5692b93
--- /dev/null
+++ b/docs/man/htcacheclean.8
@@ -0,0 +1,74 @@
+.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+.\" DO NOT EDIT! Generated from XML source.
+.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "HTCACHECLEAN" 8 "2004-11-06" "Apache HTTP Server" "htcacheclean"
+
+.SH NAME
+htcacheclean \- Clean up the disk cache
+
+.SH "SYNOPSIS"
+ 
+.PP
+\fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBr\fR ] [ -\fBn\fR ] -\fBp\fR\fIpath\fR -\fBl\fR\fIlimit\fR
+ 
+.PP
+\fBhtcacheclean\fR -\fBb\fR [ -\fBn\fR ] [ -\fBi\fR ] -\fBd\fR\fIinterval\fR -\fBp\fR\fIpath\fR -\fBl\fR\fIlimit\fR
+ 
+
+.SH "SUMMARY"
+ 
+.PP
+htcacheclean is used to keep the size of mod_disk_cache's storage within a certain limit\&. This tool can be either run manually or in daemon mode\&. When running in daemon mode, it sleeps in the background and checks the cache directories in regular intervals for stuff to be removed\&. You can stop the daemon cleanly, when sending him a TERM or INT signal\&.
+ 
+
+.SH "OPTIONS"
+ 
+ 
+.TP
+-d\fIinterval\fR
+Daemonize and repeat cache cleaning every \fIinterval\fR minutes\&. This option is mutually exclusive with the -D, -v and -r options\&. To shutdown the daemon cleanly, just send it a SIGTERM or SIGINT\&.  
+.TP
+-D
+Do a dry run and don't delete anything\&. This option is mutually exclusive with the -d option\&.  
+.TP
+-v
+Be verbose and print statistics\&. This option is mutually exclusive with the -d option\&.  
+.TP
+-r
+Clean thoroughly\&. This assumes that the Apache web server is not running (otherwise you may get garbage in the cache)\&. This option is mutually exclusive with the -d option\&.  
+.TP
+-n
+Be nice\&. This causes slower processing in favour of other processes\&. htcacheclean will sleep from time to time so that (a) the disk IO will be delayed and (b) the kernel can schedule other processes in the meantime\&.  
+.TP
+-p\fIpath\fR
+Specify \fIpath\fR as the root directory of the disk cache\&. This should be the same value as specified with the CacheRoot directive\&.  
+.TP
+-l\fIlimit\fR
+Specify \fIlimit\fR as the total disk cache size limit\&. The value is expressed in bytes by default (or attaching B to the number)\&. Attach K for Kbytes or M for MBytes\&.  
+.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\&.  
+ 
+.SH "EXIT STATUS"
+ 
+.PP
+htcacheclean returns a zero status ("true") if all operations were successful, 1 otherwise\&.
+