NFS Services Administrator's Guide (5900-1632, August 2011)

To delete a cache directory and all the CacheFS filesystems in that directory, enter the following
command:
cfsadmin -d all cache-directory
Using CacheFS
After the administrator has configured a cache directory and mounted or automounted the CacheFS
filesystem, you can use CacheFS as you would any other filesystem.
The first time you access data through CacheFS, an over-the-wire call is made to the NFS server
and the data is copied to your local cache. The first request is slow. However, all subsequent
accesses are faster as they are served from the local cache.
Displaying CacheFS Statistics
The cachefsstat command displays statistical information about the mounted cache filesystem.
This includes the number of cache hits, cache misses, consistency checks, and modification
operations, such as writes and creates. The cachefswssize command displays the working set
size. The working set size includes information on the amount of cache space that each filesystem
in a cache directory uses. It can also be used to display the contents of the logfile. The logfile
created when you enable logging is used as an input to calculate the working set size.
Viewing the CacheFS Statistics
In the following example, /home/smh is the CacheFS mount-point. To view the CacheFS statistics,
enter the following command:
cachefsstat /home/smh
An output similar to the following is displayed:
/home/smh
cache hit rate: 20% (2543 hits, 9774 misses)
consistency checks: 47842 (47825 pass, 17 fail)
modifies: 85727
garbage collection: 0
You can run the cachefsstat command with the -z option to reinitialize CacheFS statistics.
You must be a superuser to use the -z option.
NOTE: If you do not specify the CacheFS mount-point, statistics for all CacheFS mount-points are
displayed.
For more information about the cachefsstat command, see cachefsstat(1M).
Viewing the Working Set (Cache) Size
In the following example, /cfs_mnt1 is the CacheFS mount-point and /tmp/logfile refers to
the logfile created when you enable logging. To view the memory usage, enter the following
command:
cachefswssize /tmp/logfile
An output similar to the following is displayed:
/cfs_mnt1
end size: 40k
high water size: 40k
total for cache
Initial size: 640k
end size: 40k
To view the operations performed in ASCII format, enter the following command:
cachefswssize -a /tmp/logfile
90 Configuring and Administering a Cache Filesystem