1HTCACHECLEAN(8) htcacheclean HTCACHECLEAN(8)
2
3
4
6 htcacheclean - Clean up the disk cache
7
8
10 htcacheclean [ -D ] [ -v ] [ -t ] [ -r ] [ -n ] -ppath -llimit
11
12
13 htcacheclean -b [ -n ] [ -t ] [ -i ] -dinterval -ppath -llimit
14
15
16
18 htcacheclean is used to keep the size of mod_disk_cache's storage
19 within a certain limit. This tool can run either manually or in daemon
20 mode. When running in daemon mode, it sleeps in the background and
21 checks the cache directories at regular intervals for cached content to
22 be removed. You can stop the daemon cleanly by sending it a TERM or INT
23 signal.
24
25
26
28 -dinterval
29 Daemonize and repeat cache cleaning every interval minutes. This
30 option is mutually exclusive with the -D, -v and -r options. To
31 shutdown the daemon cleanly, just send it a SIGTERM or SIGINT.
32
33 -D Do a dry run and don't delete anything. This option is mutually
34 exclusive with the -d option.
35
36 -v Be verbose and print statistics. This option is mutually exclu‐
37 sive with the -d option.
38
39 -r Clean thoroughly. This assumes that the Apache web server is not
40 running (otherwise you may get garbage in the cache). This
41 option is mutually exclusive with the -d option and implies the
42 -t option.
43
44 -n Be nice. This causes slower processing in favour of other pro‐
45 cesses. htcacheclean will sleep from time to time so that (a)
46 the disk IO will be delayed and (b) the kernel can schedule
47 other processes in the meantime.
48
49 -t Delete all empty directories. By default only cache files are
50 removed, however with some configurations the large number of
51 directories created may require attention. If your configuration
52 requires a very large number of directories, to the point that
53 inode or file allocation table exhaustion may become an issue,
54 use of this option is advised.
55
56 -ppath Specify path as the root directory of the disk cache. This
57 should be the same value as specified with the CacheRoot direc‐
58 tive.
59
60 -llimit
61 Specify limit as the total disk cache size limit. The value is
62 expressed in bytes by default (or attaching B to the number).
63 Attach K for Kbytes or M for MBytes.
64
65 -i Be intelligent and run only when there was a modification of the
66 disk cache. This option is only possible together with the -d
67 option.
68
69
71 htcacheclean returns a zero status ("true") if all operations were suc‐
72 cessful, 1 otherwise.
73
74
75
76
77Apache HTTP Server 2005-08-08 HTCACHECLEAN(8)