xref: /linux/Documentation/ABI/testing/procfs-nfsd-reply_cache_stats (revision 570f7e331f5febb30f1384817463c7e42b65ca7d)
1What:		/proc/fs/nfsd/reply_cache_stats
2Date:		March 2013
3KernelVersion:	3.10
4Contact:	linux-nfs@vger.kernel.org
5Description:
6		Provides statistics for the NFS server duplicate reply
7		cache (DRC). The file contains one labeled field per
8		line. Each line has the form "field name:" followed by
9		whitespace and a decimal value.
10
11		Fields:
12
13		=======================  ======  ==========================
14		max entries              u32     Upper bound on cache size
15		num entries              u32     Current entry count
16		hash buckets             u32     Number of hash buckets
17		mem usage                s64     Bytes consumed by the DRC
18		cache hits               s64     Requests answered from cache
19		cache misses             s64     Requests not found in cache
20		not cached               s64     Idempotent requests that
21		                                 bypass the cache
22		payload misses           s64     XID matched but request
23		                                 checksum did not
24		longest chain len        u32     Longest hash chain observed
25		cachesize at longest     u32     Cache size when longest
26		                                 chain was recorded
27		=======================  ======  ==========================
28
29		Counter fields (cache hits, cache misses, not cached,
30		payload misses, mem usage) are maintained with per-cpu
31		counters and may briefly show stale values under
32		concurrent load. There is no way to reset these
33		counters; consumers should compute rates by sampling
34		over time.
35
36		New fields may be appended in future kernels. Parsers
37		should match on field name, not line position.
38Users:		nfs-utils (https://git.linux-nfs.org/?p=steved/nfs-utils.git)
39