NAME

fs_setcachesize - Sets the size of the disk cache

SYNOPSIS

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

DESCRIPTION

The fs setcachesize command (alias fs cachesize) 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 Microsoft Windows or UNIX machines that use a memory cache.

To return the cache size to the default value, 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.

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 Microsoft Windows or UNIX machines using a memory cache, and results in an error message. To change memory cache size on UNIX machines, modify the blocks parameter in the [afsd] section of the configuration /etc/yfs/yfs-client.conf file.

On UNIX 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 (0 = reset)>

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 set in the configuration file.

-reset

Returns the cache size to the value set when the machine was last booted.

-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 initial value.

   % fs setcachesize -blocks 0
   % fs setcachesize -reset

PRIVILEGE REQUIRED

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

SEE ALSO

afsd(8), fs_getcacheparms(1), yfs-client.conf(5)

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.

ACKNOWLEDGEMENTS

"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.