Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 /usr/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				  2016-12-14		    FS_SETCACHESIZE(1)

NAME | SYNOPSIS | DESCRIPTION | CAUTIONS | OPTIONS | EXAMPLES | PRIVILEGE REQUIRED | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fs_setcachesize&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help