NAME
cachefsstat — Cache File System statistics
SYNOPSIS
cachefsstat
[ -z ]
[
path... ]
DESCRIPTION
The
cachefsstat
command displays statistical information about the cache filesystem mounted on
path.
The statistical information includes cache hits and misses, consistency
checking, and modification operations.
If
path
is not specified, all mounted cache filesystems 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:
- cache 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.
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 used by the super-user. The statistics printed reflect those just
before the statistics are re-initialized.
EXAMPLES
example% cachefsstat /home/sam
cache hit rate: 73% (1234 hits, 450 misses)
consistency checks: 700 (650 pass, 50 fail)
modifies: 321
EXIT STATUS
The following exit values are returned:
- 0
Success.
- non-zero
An error has occurred.
AUTHOR
cachefsstat
was developed by Sun Microsystems, Inc.
