1GANESHA-CACHE-CONFIG(8)           NFS-Ganesha          GANESHA-CACHE-CONFIG(8)
2
3
4

NAME

6       ganesha-cache-config - NFS Ganesha Cache Configuration File
7

SYNOPSIS

9       /etc/ganesha/ganesha.conf
10
11

DESCRIPTION

13       NFS-Ganesha  reads  the  configuration  data from: | /etc/ganesha/gane‐
14       sha.conf
15
16       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 precedence over the CACHEINODE block.
20
21   MDCACHE {}
22       NParts (uint32, range 1 to 32633, default 7)
23              Partitions in the Cache_Inode tree.
24
25       Cache_Size(uint32, range 1 to UINT32_MAX, default 32633)
26              Per-partition hash table size.
27
28       Use_Getattr_Directory_Invalidation(bool, default false)
29              Use getattr for directory invalidation.
30
31       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. Dir_Chunk  should  always  be  enabled.
34              Most  FSAL  modules  especially FSAL_RGW/FSAL_GLUSTER need it to
35              make readdir work well.
36
37       Detached_Mult(uint32, range 1 to UINT32_MAX, default 1)
38              Max number of detached directory entries expressed as a multiple
39              of the chunk size.
40
41       Entries_HWMark(uint32, range 1 to UINT32_MAX, default 100000)
42              The point at which object cache entries will start being reused.
43
44       Entries_Release_Size(uint32, range 0 to UINT32_MAX, default 100)
45              The  number  of  entries attempted to release each time when the
46              handle cache has exceeded the entries high water mark.
47
48       Chunks_HWMark(uint32, range 1 to UINT32_MAX, default 100000)
49              The point at which dirent cache chunks will start being reused.
50
51       LRU_Run_Interval(uint32, range 1 to 24 * 3600, default 90)
52              Base interval in seconds between runs of the LRU cleaner thread.
53
54       FD_Limit_Percent(uint32, range 0 to 100, default 99)
55              The percentage of the system-imposed maximum of file descriptors
56              at which Ganesha will deny requests.
57
58       FD_HWMark_Percent(uint32, range 0 to 100, default 90)
59              The percentage of the system-imposed maximum of file descriptors
60              above which Ganesha will make greater efforts at reaping.
61
62       FD_LWMark_Percent(uint32, range 0 to 100, default 50)
63              The percentage of the system-imposed maximum of file descriptors
64              below which Ganesha will not reap file descriptors.
65
66       Reaper_Work(uint32, range 1 to 2000, default 0)
67              Roughly,  the  amount  of  work  to  do on each pass through the
68              thread under normal conditions.  (Ideally,  a  multiple  of  the
69              number  of  lanes.)   This  setting  is  deprecated.  Please use
70              Reaper_Work_Per_Lane
71
72       Reaper_Work_Per_Lane(uint32, range 1 to UINT32_MAX, default 50)
73              This is the number of handles per lane to scan  when  performing
74              LRU maintenance.  This task is performed by the Reaper thread.
75
76       Biggest_Window(uint32, range 1 to 100, default 40)
77              The  largest window (as a percentage of the system-imposed limit
78              on FDs) of work that we will do in extremis.
79
80       Required_Progress(uint32, range 1 to 50, default 5)
81              Percentage of progress toward the high water mark required in in
82              a pass through the thread when in extremis
83
84       Futility_Count(uint32, range 1 to 50, default 8)
85              Number of failures to approach the high watermark before we dis‐
86              able caching, when in extremis.
87
88       Dirmap_HWMark(uint32, range 1 to UINT32_MAX, default 10000)
89              The point at which dirmap entries are reused.  This puts a prac‐
90              tical  limit  on the number of simultaneous readdirs that may be
91              in progress on an export for a  whence-is-name  FSAL  (currently
92              only FSAL_RGW)
93

SEE ALSO

95       ganesha-config(8)
96
97
98
99
100                                 Feb 28, 2023          GANESHA-CACHE-CONFIG(8)
Impressum