NAME

cachefsstat - Cache File System statistics

SYNOPSIS

cachefsstat [ -z ] [ path... ]

AVAILABILITY

SUNWcsu

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 opterations. 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:

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 use 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.

SEE ALSO

cachefslog(1M)