1GANESHA-CONFIG(8) NFS-Ganesha GANESHA-CONFIG(8)
2
3
4
6 ganesha-config - NFS Ganesha Configuration File
7
9 /etc/ganesha/ganesha.conf
10
11
13 NFS-Ganesha obtains configuration data from the configuration file:
14 /etc/ganesha/ganesha.conf
15
16 The configuration file consists of following parts:
17
18 Comments
19 Empty lines and lines starting with '#' are comments.:
20
21 # This whole line is a comment
22 Protocol = TCP; # The rest of this line is a comment
23
24 Blocks
25 Related options are grouped together into "blocks". A block is a name
26 followed by parameters enclosed between "{" and "}". A block can con‐
27 tain other sub blocks as well.:
28
29 EXPORT
30 {
31 Export_ID = 1;
32 FSAL {
33 Name = VFS:
34 }
35 }
36
37 NOTE: FSAL is a sub block. Refer to BLOCKS section for list of blocks
38 and options.
39
40 Options
41 Configuration options can be of following types.
42
43 1. Numeric. Numeric options can be defined in octal, decimal, or hexa‐
44 decimal. The format follows ANSI C syntax. eg.:
45
46 mode = 0755; # This is octal 0755, 493 (decimal)
47
48 Numeric values can also be negated or logical NOT'd. eg.:
49
50 anonymousuid = -2; # this is a negative
51 mask = ~0xff; # Equivalent to 0xffffff00 (for 32 bit integers)
52
53 2. Boolean. Possible values are true, false, yes and no. 1 and 0 are
54 not acceptable.
55
56 3. List. The option can contain a list of possible applicable values.
57 Protocols = 3, 4, 9p;
58
59 Including other config files
60 Additional files can be referenced in a configuration using '%include'
61 and '%url' directives.:
62
63 %include <filename>
64 %url <url, e.g., rados://mypool/mynamespace/myobject>
65
66 The included file is inserted into the configuration text in place of
67 the %include or %url line. Sub-inclusions may be to any depth. File‐
68 names and URLs may optionally use '"':
69
70 %include base.conf
71 %include "base.conf"
72 %url rados://mypool/mynamespace/myobject
73 %url "rados://mypool/mynamespace/myobject"
74 %url rados://mypool/myobject
75 %url "rados://mypool/myobject"
76
77 In the case of rados:// URLs, providing a two-component URL indicates
78 that the default namespace should be used.
79
81 NFS-Ganesha supports the following blocks:
82
83 EXPORT {}
84 Along with its configuration options, the EXPORT block supports FSAL
85 and CLIENT sub-blocks. See ganesha-export-config(8) for usage of this
86 block and its sub-blocks.
87
88 EXPORT_DEFAULTS {}
89 Refer to ganesha-export-config(8) for usage
90
91 MDCACHE {}
92 Refer to ganesha-cache-config(8) for usage
93
94 NFS_CORE_PARAM {}
95 Refer to ganesha-core-config(8) for usage
96
97 NFS_IP_NAME {}
98 Refer to ganesha-core-config(8) for usage
99
100 NFS_KRB5 {}
101 Refer to ganesha-core-config(8) for usage
102
103 NFSv4 {}
104 Refer to ganesha-core-config(8) for usage
105
106 CEPH {}
107 Refer to ganesha-ceph-config(8) for usage
108
109 9P {}
110 Refer to ganesha-9p-config(8) for usage
111
112 GLUSTER {}
113 Refer to ganesha-gluster-config(8) for usage
114
115 GPFS {}
116 Refer to ganesha-gpfs-config(8) for usage
117
118 LOG {}
119 Refer to ganesha-log-config(8) for usage
120
121 1.**LOG { FACILITY {} }** 2.**LOG { FORMAT {} }**
122
123 PROXY {}
124 Refer to ganesha-proxy-config(8) for usage
125
126 RGW {}
127 Refer to ganesha-rgw-config(8) for usage
128
129 VFS {}
130 Refer to ganesha-vfs-config(8) for usage
131
132 XFS {}
133 Refer to ganesha-xfs-config(8) for usage
134
136 Along with "ganesha.conf", for each installed FSAL, a sample config
137 file is added at:
138 /etc/ganesha
139
140
142 ganesha-log-config(8) ganesha-rgw-config(8) ganesha-vfs-config(8) gane‐
143 sha-lustre-config(8) ganesha-xfs-config(8) ganesha-gpfs-config(8) gane‐
144 sha-gluster-config(8) ganesha-9p-config(8) ganesha-proxy-config(8)
145 ganesha-ceph-config(8) ganesha-core-config(8) ganesha-export-config(8)
146
147
148
149
150 Jan 28, 2021 GANESHA-CONFIG(8)