cachefsstat(1m)

1cachefsstat(1M)         System Administration Commands         cachefsstat(1M)
2
3
4

NAME

6       cachefsstat - Cache File System statistics
7

SYNOPSIS

9       /usr/bin/cachefsstat [-z] [path]...
10
11

DESCRIPTION

13       The  cachefsstat  command  displays  statistical  information about the
14       cache file system mounted on path. The statistical information includes
15       cache  hits  and  misses, consistency checking, and modification opera‐
16       tions. If path is not specified, all mounted  cache  file  systems  are
17       used.
18
19
20       cachefsstat  can  also be used to reinitialize this information (see -z
21       option).
22
23
24       The statistical information has the following format:
25
26         <cache hit rate>
27         <consistency checks>
28         <modifies>
29
30
31
32
33       where:
34
35       hit rate              The percentage of cache hits over the total  num‐
36                             ber  of  attempts, followed by the actual numbers
37                             of hits and misses.
38
39
40       consistency checks    The number of consistency checks performed,  fol‐
41                             lowed  by  the number that passed, and the number
42                             that failed.
43
44
45       modifies              The  number  of  modify   operations,   including
46                             writes, creates, etc.
47
48

OPTIONS

50       The following option is supported:
51
52       -z    Zero  (reinitialize)  statistics.  Execute  cachefsstat -z before
53             executing cachefsstat again to gather  statistics  on  the  cache
54             performance.  This  option  can only be use by the superuser. The
55             statistics printed reflect those just before the  statistics  are
56             reinitialized.
57
58

USAGE

60       See  largefile(5)  for  the  description of the behavior of cachefsstat
61       when encountering files greater than or equal to 2 Gbyte (2^31 bytes).
62

EXAMPLES

64       Example 1 Using cachefsstat
65
66
67       The following example shows the cachefsstat command run on file  system
68       /test:
69
70
71         example# cachefsstat /test
72           /test
73                cache hit rate:      100% (0 hits, 0 misses)
74                consistency checks:    0  (0 pass, 0 fail)
75                modifies:              0
76         garbage collection:           0
77
78
79

EXIT STATUS

81       The following exit values are returned:
82
83       0           Successful completion.
84
85
86       non-zero    An error occurred.
87
88

ATTRIBUTES

90       See attributes(5) for descriptions of the following attributes:
91
92
93
94
95       ┌─────────────────────────────┬─────────────────────────────┐
96       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
97       ├─────────────────────────────┼─────────────────────────────┤
98       │Availability                 │SUNWcsu                      │
99       └─────────────────────────────┴─────────────────────────────┘
100