cachefsstat

 

---

 
 
 
 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),   attri-
      butes(5), largefile(5)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 16 Sep 1996                    2
 
 
 

---