Maintenance Commands                              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  reini-
           tialized.

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

SunOS 5.8           Last change: 16 Sep 1996                    1

Maintenance Commands                              cachefsstat(1M)

EXAMPLES
     Example 1: Example of cachefsstat.

     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.

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),   attributes(5)
     , largefile(5)

SunOS 5.8           Last change: 16 Sep 1996                    2