NAME
cachefsstat — Cache File System statistics
SYNOPSIS
/usr/sbin/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 description for the
-z
option).
The statistical information has the following format:
<cache hit rate>
<consistency checks>
<modifies>
where each of the above is defined as:
- 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, and so on.
Options
cachefsstat
recognizes the following option:
- -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 superuser.
The statistics printed reflect those just before the statistics are reinitialized.
RETURN VALUE
cachefsstat
returns the following values:
- 0
Success.
- non-zero
An error occurred.
EXAMPLES
% cachefsstat /home/sam
cache hit rate: 73% (1234 hits, 450 misses)
consistency checks: 700 (650 pass, 50 fail)
modifies: 321
AUTHOR
cachefsstat
was developed by Sun Microsystems, Inc.
Printable version
