cachefsstat(1M)

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 speci-
     fied, all mounted cache file systems are used.

     cachefsstat can also be used to reinitialize  this  informa-
     tion (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 statis-
           tics 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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

     cachefslog(1M),  cachefswssize(1M),   cfsadmin(1M),   attri-
     butes(5), largefile(5)