Provided by: openafs-client_1.6.1-1_i386 bug

NAME

       fs_setcachesize - Sets the size of the disk cache

SYNOPSIS

       fs setcachesize [-blocks <size (0 = reset)>>] [-reset] [-help]

       fs setca [-b <size (0 = reset)>>] [-r] [-h]

       fs cachesize [-b <size (0 = reset)>>] [-r] [-h]

       fs ca [-b <size (0 = reset)>>] [-r] [-h]

DESCRIPTION

       The fs setcachesize command changes the number of kilobyte blocks of
       local disk space available to the Cache Manager for its data cache, on
       machines that use a disk cache. The command is not operative on
       machines that use a memory cache.

       To return the cache size to the default value specified in the third
       field of the local /etc/openafs/cacheinfo file, provide a value of 0 to
       the -blocks argument.

       To return the cache size to the value set when the machine was last
       rebooted, use the -reset flag instead of the -blocks argument. This is
       normally the amount specified in the cacheinfo file, unless the -blocks
       argument was included on the afsd command to override the cacheinfo
       value.

       To display the current cache size and amount of cache in use, for both
       disk and memory caches, use the fs getcacheparms command.

CAUTIONS

       This command is not operative on machines using a memory cache, and
       results in an error message. To change memory cache size, edit the
       cacheinfo file and reboot, or reboot and provide the -blocks argument
       to the afsd command.

       On machines using a disk cache, do not set the cache size to exceed 85%
       to 90% of the actual disk space available for the cache directory. The
       cache implementation itself requires a small amount of space on the
       partition.

OPTIONS

       -blocks <size>
           Specifies the amount of disk space available for the Cache Manager
           to devote to the cache.  The size should be a positive integer
           followed by an optional suffix: "K" for kibibytes (1024 bytes, the
           default), "M" for mebibytes (1024 kibibytes), "G" for gibibytes
           (1024 mebibytes), and "T" for tebibytes (1024 gibibytes).  Provide
           a value of 0 to set cache size to the default specified in the
           cacheinfo file.

       -reset
           Returns the cache size to the value set when the machine was last
           booted. This agrees with the value in the cacheinfo file unless the
           -blocks argument was used on the afsd command.

       -help
           Prints the online help for this command. All other valid options
           are ignored.

EXAMPLES

       The following command sets the disk cache size to 25000 kilobyte
       blocks.

          % fs setcachesize -blocks 25000

       Both of the following commands reset the disk cache size to the value
       in the cacheinfo file, assuming that the -blocks argument to the afsd
       command was not used.

          % fs setcachesize -blocks 0
          % fs setcachesize -reset

PRIVILEGE REQUIRED

       The issuer must be logged in as the local superuser root.

SEE ALSO

       cacheinfo(5), afsd(8), fs_getcacheparms(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.