cacheinfo5

Overview

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