fs_getcacheparms(1) [php man page]
FS_GETCACHEPARMS(1) AFS Command Reference FS_GETCACHEPARMS(1) NAME
fs_getcacheparms - Displays the current size and usage of the cache SYNOPSIS
fs getcacheparms [-help] [-files] [-excessive] fs getca [-h] [-files] [-excessive] DESCRIPTION
The fs getcacheparms command displays the current size of the cache (which can be in memory or on disk), and the amount currently in use. The reported statistics are from kernel memory, so the reported size can differ from the setting specified in the /etc/openafs/cacheinfo file on a machine using a disk cache, if the fs setcachesize command has been used to alter cache size. OPTIONS
-help Prints the online help for this command. All other valid options are ignored. -files Displays the current number of cache files in use, and the maximum available, as well as displaying the current cache size. -excessive Displays detailed cache statistics, including the flags set on each cache element, and the distribution of cache entries by size. OUTPUT
The output reports AFS using <amount> of the cache's available <size> 1K byte blocks. where <amount> is the number of kilobyte blocks currently used to cache data and status information, and <size> is the total current cache size. EXAMPLES
The following example shows the output on a machine with a 25000 kilobyte cache. % fs getcacheparms AFS using 22876 of the cache's available 25000 1K byte blocks. The following shows the output when asked to show file information. % fs getcacheparm -files AFS using 0% of cache blocks (897 of 200000 1k blocks) 1% of the cache files (79 of 6250 files) And finally, the following detailed information can be obtained by using the excessive flag % fs getcacheparm -excessive AFS using 0% of cache blocks (897 of 200000 1k blocks) 1% of the cache files (79 of 6250 files) afs_cacheFiles: 6250 IFFree: 6171 IFEverUsed: 79 IFDataMod: 0 IFDirtyPages: 0 IFAnyPages: 0 IFDiscarded: 1 DCentries: 3122 0k- 4K: 74 4k- 16k: 3045 16k- 64k: 2 64k- 256k: 0 256k- 1M: 1 >=1M: 0 PRIVILEGE REQUIRED
None SEE ALSO
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 FS_GETCACHEPARMS(1)
Check Out this Related 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)