1cachefsstat(1M) System Administration Commands cachefsstat(1M)
2
3
4
6 cachefsstat - Cache File System statistics
7
9 /usr/bin/cachefsstat [-z] [path]...
10
11
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
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
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
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
81 The following exit values are returned:
82
83 0 Successful completion.
84
85
86 non-zero An error occurred.
87
88
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
102 cachefslog(1M), cachefswssize(1M), cfsadmin(1M), attributes(5), large‐
103 file(5)
104
105
106
107SunOS 5.11 9 Oct 2003 cachefsstat(1M)