cachefsstat(1M) System Administration Commands cachefsstat(1M)NAMEcachefsstat - Cache File System statistics
SYNOPSIS
/usr/bin/cachefsstat [-z] [path]...
DESCRIPTION
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 opera‐
tions. If path is not specified, all mounted cache file systems are
used.
cachefsstat can also be used to reinitialize this information (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 num‐
ber of attempts, followed by the actual numbers
of hits and misses.
consistency checks The number of consistency checks performed, fol‐
lowed by the number that passed, and the number
that failed.
modifies The number of modify operations, including
writes, creates, etc.
OPTIONS
The following option is supported:
-z Zero (reinitialize) statistics. Execute cachefsstat-z before
executing cachefsstat again to gather statistics on the cache
performance. This option can only be use by the superuser. The
statistics printed reflect those just before the statistics are
reinitialized.
USAGE
See largefile(5) for the description of the behavior of cachefsstat
when encountering files greater than or equal to 2 Gbyte (2^31 bytes).
EXAMPLES
Example 1 Using cachefsstat
The following example shows the cachefsstat command run on file system
/test:
example# cachefsstat /test
/test
cache hit rate: 100% (0 hits, 0 misses)
consistency checks: 0 (0 pass, 0 fail)
modifies: 0
garbage collection: 0
EXIT STATUS
The following exit values are returned:
0 Successful completion.
non-zero An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcs │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOcachefslog(1M), cachefswssize(1M), cfsadmin(1M), attributes(5), large‐
file(5)SunOS 5.11 9 Oct 2003 cachefsstat(1M)
