1GANESHA-CACHE-CONFIG(8) NFS-Ganesha GANESHA-CACHE-CONFIG(8)
2
6 ganesha-cache-config - NFS Ganesha Cache Configuration File
7
9 /etc/ganesha/ganesha.conf
10
13 NFS-Ganesha reads the configuration data from: | /etc/ganesha/gane‐
14 sha.conf
15 This file lists NFS-Ganesha Cache config options. These options used
17 to be configured in the CACHEINODE block. They may still be used in
18 that block, but it is deprecated and will go away. The MDCACHE block
19 takes precidence over the CACHEINODE block.
20 MDCACHE {}
22 NParts (uint32, range 1 to 32633, default 7)
23 Partitions in the Cache_Inode tree.
24 Cache_Size(uint32, range 1 to UINT32_MAX, default 32633)
26 Per-partition hash table size.
27 Use_Getattr_Directory_Invalidation(bool, default false)
29 Use getattr for directory invalidation.
30 Dir_Chunk(uint32, range 0 to UINT32_MAX, default 128)
32 Size of per-directory dirent cache chunks, 0 means directory
33 chunking is not enabled.
34 Detached_Mult(uint32, range 1 to UINT32_MAX, default 1)
36 Max number of detached directory entries expressed as a multiple
37 of the chunk size.
38 Entries_HWMark(uint32, range 1 to UINT32_MAX, default 100000)
40 The point at which object cache entries will start being reused.
41 Entries_Release_Size(uint32, range 0 to UINT32_MAX, default 100)
43 The number of entries attempted to release each time when the
44 handle cache has exceeded the entries high water mark.
45 Chunks_HWMark(uint32, range 1 to UINT32_MAX, default 100000)
47 The point at which dirent cache chunks will start being reused.
48 LRU_Run_Interval(uint32, range 1 to 24 * 3600, default 90)
50 Base interval in seconds between runs of the LRU cleaner thread.
51 FD_Limit_Percent(uint32, range 0 to 100, default 99)
53 The percentage of the system-imposed maximum of file descriptors
54 at which Ganesha will deny requests.
55 FD_HWMark_Percent(uint32, range 0 to 100, default 90)
57 The percentage of the system-imposed maximum of file descriptors
58 above which Ganesha will make greater efforts at reaping.
59 FD_LWMark_Percent(uint32, range 0 to 100, default 50)
61 The percentage of the system-imposed maximum of file descriptors
62 below which Ganesha will not reap file descriptors.
63 Reaper_Work(uint32, range 1 to 2000, default 0)
65 Roughly, the amount of work to do on each pass through the
66 thread under normal conditions. (Ideally, a multiple of the
67 number of lanes.) This setting is deprecated. Please use
68 Reaper_Work_Per_Lane
69 Reaper_Work_Per_Lane(uint32, range 1 to UINT32_MAX, default 50)
71 This is the numer of handles per lane to scan when performing
72 LRU maintenance. This task is performed by the Reaper thread.
73 Biggest_Window(uint32, range 1 to 100, default 40)
75 The largest window (as a percentage of the system-imposed limit
76 on FDs) of work that we will do in extremis.
77 Required_Progress(uint32, range 1 to 50, default 5)
79 Percentage of progress toward the high water mark required in in
80 a pass through the thread when in extremis
81 Futility_Count(uint32, range 1 to 50, default 8)
83 Number of failures to approach the high watermark before we dis‐
84 able caching, when in extremis.
85 Dirmap_HWMark(uint32, range 1 to UINT32_MAX, default 10000)
87 The point at which dirmap entries are reused. This puts a prac‐
88 tical limit on the number of simultaneous readdirs that may be
89 in progress on an export for a whence-is-name FSAL (currently
90 only FSAL_RGW)
91
93 ganesha-config(8)
94 Jan 28, 2023 GANESHA-CACHE-CONFIG(8)