man/man1m/cachefsstat.1m

         te
 Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 CACHEFSSTAT 1M "Oct 9, 2003"
 NAME
cachefsstat - 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 operations. 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 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 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.


 SEE ALSO

cachefslog(1M), cachefswssize(1M), cfsadmin(1M),
attributes(5), largefile(5)