osx man page for cachefsstat

cachefsstat(1M) 					  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 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 per-
		formance. 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.10							    9 Oct 2003							   cachefsstat(1M)