fs_setcachesize(1) [centos man page]

FS_SETCACHESIZE(1)					       AFS Command Reference						FS_SETCACHESIZE(1)

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.

OpenAFS 							    2012-03-26							FS_SETCACHESIZE(1)

Check Out this Related Man Page

CACHEINFO(5)							AFS File Reference						      CACHEINFO(5)

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 							    2012-03-26							      CACHEINFO(5)

Linux and UNIX Man Pages

fs_setcachesize(1) [centos man page]

Check Out this Related Man Page