NAME¶
cacheinfo - Defines configuration parameters for the Cache Manager
DESCRIPTION¶
The
cacheinfo file defines configuration parameters for the Cache
Manager, which reads the file as it initializes.
The file contains a single line of ASCII text and must reside in the
/etc/openafs directory. Use a text editor to create it during initial
configuration of the client machine; the required format is as follows:
<mount>:<cache>:<size>
where
- <mount>
- Names the local disk directory at which the Cache Manager
mounts the AFS namespace. It must exist before the afsd program
runs. The conventional value is /afs. Using any other value
prevents traversal of pathnames that begin with /afs (such as
pathnames to files in foreign cells that do use the conventional name).
The -mountdir argument to the afsd command overrides this
value.
- <cache>
- Names the local disk directory to use as a cache. It must
exist before the afsd program runs. The standard value is
/usr/vice/cache, but it is acceptable to substitute a directory on
a partition with more available space. Although the Cache Manager ignores
this field when configuring a memory cache, a value must always appear in
it. The -cachedir argument to the afsd command overrides
this value.
- <size>
- Specifies the cache size as a number of 1-kilobyte blocks.
Larger caches generally yield better performance, but a disk cache must
not exceed 90% of the space available on the cache partition (85% for AIX
systems), and a memory cache must use no more than 25% of available
machine memory.
The -blocks argument to the afsd command overrides this value. To
reset cache size without rebooting on a machine that uses disk caching,
use the fs setcachesize command. To display the current size of a
disk or memory cache between reboots, use the fs getcacheparms
command.
EXAMPLES¶
The following example cacheinfo file mounts the AFS namespace at
/afs,
establishes a disk cache in the
/usr/vice/cache directory, and defines
cache size as 50,000 1-kilobyte blocks.
/afs:/usr/vice/cache:50000
SEE ALSO¶
afsd(8),
fs_getcacheparms(1),
fs_setcachesize(1)
COPYRIGHT¶
IBM Corporation 2000. <
http://www.ibm.com/> All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was
converted from HTML to POD by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.