Content-type: text/html Man page of cachefsstat

cachefsstat

Section: System Administration Commands (1M)
Updated: 9 Oct 2003
Index Return to Main Contents
 

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 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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWcsu

 

SEE ALSO

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
USAGE
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:08 GMT, October 02, 2010