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.

OpenAFS                                            2025-05-19                                       CACHEINFO(5)