.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: cacheadm.1[3.0] Thu Jan 13 15:30:55 1994 andy@cs.tu-berlin.de frozen $
..
.TH cacheadm 1 "Thu Jan 13 15:30:55 1994" "AtFS-1.71" "ShapeTools"
.SH NAME
cacheadm \- administer and configure AtFS derived object cache
.SH SYNOPSIS
.B cacheadm
.RB [ \-A \fImax_cached_per_cacheattr\fP ]
.RB [ \-N \fImax_cached_per_name\fP ]
.RB [ \-T \fImax_total_cached\fP ]
.RB [ \-q ]
.RB [ \-v ]
.I directories
.SH DESCRIPTION
\fIcacheadm\fP provides control over the size of a
derived object cache. You may set the maximum total number (T)
of derived files to be stored, the maximum number of derived files per
name (N) and the maximum number of derived files with the same
name and the same caching attribute (A). Called without any options, 
\fIcacheadm\fP returns the actual sizes of the derived object caches
in the named dirctories. An empty list of directories causes
\fIcacheadm\fP to operate on the current directory.
.LP
The relationship of the three cache size values must always be
T\ >=\ N\ >=\ A. The caching attribute mechanism is described on the
af_cache(3) manual page.
When calculating your caching sizes you should keep in mind that you
may set the total size (\fIT\fP) to any value but your cache 
will never grow bigger than \fIN\|*\|number_of_names\fP.
Number_of_names is the number of source object histories in your
directories, where derived objects may be compiled from. If you
set \fIT\fP to an astronomic value, the cache adapt it's size to the
number of source histories automatically.
.LP
In the current implementation, the caching sizes can only be
increased. Reduction of the maximum cache size is only possible when
the cache is empty. Hence you have to clean your cache
(atfsrepair\ -C\ (1)) first if you want to shrink its size.
.SH OPTIONS
.TP 2c
\fB-A\fP \fImax_cached_per_cacheattr\fP
Set the maximum number of derived files with the same name and the
same caching attribute to be stored. Default is 1.
.TP
\fB-N\fP \fImax_cached_per_name\fP
Set the maximum number of derived files with the same name to be
stored. Default is 3.
.TP
\fB-T\fP \fImax_total_cached\fP
Set the total maximum number of derived files to be stored in the
derived object cache. Default is 64.
\fB-q\fP
Quiet operation. Suppresses any output to stdout. This option does not
affect error messages (stderr).
.TP
\fB-v\fP
Output version identification string.
.SH SEE ALSO
chgrp(1), chmod(1), atfsrepair(1), af_cache(3)
.SH AUTHOR
Andreas.Lampen@cs.tu-berlin.de