System Administration 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:

       
       
       




     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  per-
                           formed,  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.



SunOS 5.11           Last change: 9 Oct 2003                    1






System Administration Commands                    cachefsstat(1M)



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.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    


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








SunOS 5.11           Last change: 9 Oct 2003                    2