- online man pages   

SunOS man pages : cachefsstat (1)

Maintenance Commands                              cachefsstat(1M)


cachefsstat - Cache File System statistics


/usr/bin/cachefsstat [ -z ] [ path ... ]


The cachefsstat command displays statistical information about the cache file system mounted on path. The statistical information includes cache hits and misses, consistency checking, and modification operations. If path is not speci- fied, all mounted cache file systems are used. cachefsstat can also be used to reinitialize this informa- tion (see -z option). The statistical information has the following format: <cache hit rate> <consistency checks> <modifies> where: hit rate The percentage of cache hits over the total number of attempts, followed by the actual numbers of hits and misses. consistency checks The number of consistency checks performed, followed by the number that passed, and the number that failed. modifies The number of modify operations, including writes, creates, etc.


The following option is supported: -z Zero (reinitialize) statistics. Execute cachefsstat -z before executing cachefsstat again to gather statis- tics on the cache performance. This option can only be use by the superuser. The statistics printed reflect those just before the statistics are reini- tialized.


See largefile(5) for the description of the behavior of cachefsstat when encountering files greater than or equal to 2 Gbyte ( 2**31 bytes). SunOS 5.8 Last change: 16 Sep 1996 1 Maintenance Commands cachefsstat(1M)


Example 1: Example of cachefsstat. example% cachefsstat /home/sam cache hit rate: 73% (1234 hits, 450 misses) consistency checks: 700 (650 pass, 50 fail) modifies: 321


The following exit values are returned: 0 success non-zero an error has occurred.


See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________|


cachefslog(1M), cachefswssize(1M), cfsadmin(1M), attributes(5) , largefile(5) SunOS 5.8 Last change: 16 Sep 1996 2