NAME

fs_getcacheparms - Displays the current size and usage of the cache

SYNOPSIS

fs getcacheparms [-help] [-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 configuration 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

No special privileges are required for this command.

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.

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.