Subversion Repositories configs

Rev

Rev 192 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
192 - 1
#
2
# Define default options for autofs.
3
#
4
[ autofs ]
5
#
6
# master_map_name - default map name for the master map.
7
#
8
#master_map_name = auto.master
9
#
10
# timeout - set the default mount timeout in secons. The internal
11
#	    program default is 10 minutes, but the default installed
12
#	    configuration overrides this and sets the timeout to 5
13
#	    minutes to be consistent with earlier autofs releases.
14
#
15
timeout = 300
16
#
193 - 17
# master_wait - set the default maximum number of retries (actual
18
# 		iterations is half this, each is delayed by 2 seconds
19
# 		before retrying) waiting for the master map to become
20
# 		available if it cannot be read at program start
21
# 		(default 10, then continue). This can be longer
22
# 		if the map source itself waits for availability
23
# 		(such as sss).
192 - 24
#
25
#master_wait = 10
26
#
27
# negative_timeout - set the default negative timeout for
28
# 		     failed mount attempts (default 60).
29
#
30
#negative_timeout = 60
31
#
32
# mount_verbose - use the -v flag when calling mount(8) and log some
33
#		  process information about the requestor and its
34
#		  parent.
35
#
36
#mount_verbose = no
37
#
38
# mount_wait - time to wait for a response from mount(8).
39
# 	       Setting this timeout can cause problems when
40
# 	       mount would otherwise wait for a server that
41
# 	       is temporarily unavailable, such as when it's
42
# 	       restarting. The default setting (-1) of waiting
43
# 	       for mount(8) usually results in a wait of around
44
# 	       3 minutes.
45
#
46
#mount_wait = -1
47
#
48
# umount_wait - time to wait for a response from umount(8).
49
#
50
#umount_wait = 12
51
#
52
# browse_mode - maps are browsable by default.
53
#
54
browse_mode = no
55
#
56
# mount_nfs_default_protocol - set the default protocol that mount.nfs(8)
57
# 			       uses when performing a mount. Autofs needs
58
# 			       to know the default NFS protocol that
59
# 			       mount.nfs(8) uses so it can do special case
60
# 			       handling for its availability probe for
61
# 			       different NFS protocols. Since we can't
62
# 			       identify the default automatically we need
63
# 			       to set it in our configuration.
64
#
65
#mount_nfs_default_protocol = 3
66
mount_nfs_default_protocol = 4
67
#
68
# append_options - append to global options instead of replace.
69
#
70
#append_options = yes
71
#
72
# logging - set default log level "none", "verbose" or "debug"
73
#
74
#logging = none
75
#
76
# force_standard_program_map_env - disable the use of the "AUTOFS_"
77
#			prefix for standard environemt variables when
78
#			executing a program map. Since program maps
79
#			are run as the privileded user this opens
80
#			automount(8) to potential user privilege
81
#			escalation when the program map is written
82
#			in a language that  can load components from,
83
#			for example, a user home directory.
84
#
85
# force_standard_program_map_env = no
86
#
87
# use_mount_request_log_id - Set whether to use a mount request log
88
#			id so that log entries for specific mount
89
#			requests can be easily identified in logs
90
#			that have multiple conncurrent requests.
91
#
92
#use_mount_request_log_id = no
93
#
94
# Define base dn for map dn lookup.
95
#
96
# Define server URIs
97
#
98
# ldap_uri - space seperated list of server uris of the form
99
# 	     <proto>://<server>[/] where <proto> can be ldap
100
# 	     or ldaps. The option can be given multiple times.
101
# 	     Map entries that include a server name override
102
# 	     this option.
103
#
104
#	     This configuration option can also be used to
105
#	     request autofs lookup SRV RRs for a domain of
106
#	     the form <proto>:///[<domain dn>]. Note that a
107
#	     trailing "/" is not allowed when using this form.
108
#	     If the domain dn is not specified the dns domain
109
#	     name (if any) is used to construct the domain dn
110
#	     for the SRV RR lookup. The server list returned
111
#	     from an SRV RR lookup is refreshed according to
112
#	     the minimum ttl found in the SRV RR records or
113
#	     after one hour, whichever is less.
114
#
115
#ldap_uri = ""
116
#
117
# ldap_timeout - timeout value for the synchronous API  calls
118
#		  (default is LDAP library default).
119
#
120
#ldap_timeout = -1
121
#
122
# ldap_network_timeout - set the network response timeout (default 8).
123
#
124
#ldap_network_timeout = 8
125
#
126
# search_base - base dn to use for searching for map search dn.
127
# 		Multiple entries can be given and they are checked
128
# 		in the order they occur here.
129
#
130
#search_base = ""
131
#
132
# Define the LDAP schema to used for lookups
133
#
134
# If no schema is set autofs will check each of the schemas
135
# below in the order given to try and locate an appropriate
136
# basdn for lookups. If you want to minimize the number of
137
# queries to the server set the values here.
138
#
139
#map_object_class = nisMap
140
#entry_object_class = nisObject
141
#map_attribute = nisMapName
142
#entry_attribute = cn
143
#value_attribute= nisMapEntry
144
#
145
# Other common LDAP naming
146
#
147
#map_object_class = automountMap
148
#entry_object_class = automount
149
#map_attribute = ou
150
#entry_attribute = cn
151
#value_attribute= automountInformation
152
#
153
#map_object_class = automountMap
154
#entry_object_class = automount
155
#map_attribute = automountMapName
156
#entry_attribute = automountKey
157
#value_attribute= automountInformation
158
#
159
# auth_conf_file - set the default location for the SASL
160
#		   authentication configuration file.
161
#
162
#auth_conf_file = /etc/autofs_ldap_auth.conf
163
#
164
# map_hash_table_size - set the map cache hash table size.
165
# 			Should be a power of 2 with a ratio of
166
# 			close to 1:8 for acceptable performance
167
# 			with maps up to around 8000 entries.
168
# 			See autofs.conf(5) for more details.
169
#
170
#map_hash_table_size = 1024
171
#
172
# use_hostname_for_mounts - nfs mounts where the host name resolves
173
# 			 to more than one IP address normally need
174
# 			 to use the IP address to esure a mount to
175
# 			 a host that isn't responding isn't done.
176
# 			 If that behaviour is not wanted then set
177
#			 ths to "yes", default is "no".
178
#
179
#use_hostname_for_mounts = "no"
180
#
181
# disable_not_found_message - The original request to add this log message
182
# 			 needed it to be unconditional. That produces, IMHO,
183
# 			 unnecessary noise in the log so a configuration option
184
# 			 has been added to provide the ability to turn it off.
185
# 			 The default is "no" to maintain the current behaviour.
186
#
187
#disable_not_found_message = "no"
188
#
189
# use_ignore_mount_option - This option is used to enable the use of autofs
190
#			pseudo option "disable". This option is used as a
191
#			hint to user space that the mount entry should be
192
#			ommitted from mount table listings. The default is
193
#			"no" to avoid unexpected changes in behaviour and
194
#			so is an opt-in setting.
195
#
196
#use_ignore_mount_option = no
197
#
198
# sss_master_map_wait - When sssd is starting up it can sometimes return
193 - 199
#			"no such entry" for a short time until it has read
192 - 200
# 			in the LDAP map information. Internal default is 0
193 - 201
# 			(don't wait) or 10 if sss supports returning EHSTDOWN.
202
# 			If there is a problem with autofs not finding the
203
# 			master map at startup (when it should) then try setting
204
# 			this to 10 or more. If the sss library supports returning
205
# 			EHOSTDOWN when the provider is down then this value
206
# 			is how long to wait between retries reading the
207
# 			master map. When reading dependent maps or looking
208
# 			up a map key this value is multiplied by the number
209
# 			of retries that would be used when reading the master
210
# 			map. (Default, 0 or 10 if sss suppprts returning
211
# 			EHOSTDOWN).
192 - 212
#
213
#sss_master_map_wait = 0
214
#
215
# Options for the amd parser within autofs.
216
#
217
# amd configuration options that are aren't used, haven't been
218
# implemented or have different behaviour within autofs.
219
#
220
# A number of the amd configuration options are not used by autofs,
221
# some because they are not relevant within autofs, some because
222
# they are done differently in autofs and others that are not yet
223
# implemented.
224
#
225
# Since "mount_type" is always autofs (because there's no user space
226
# NFS server) the configuration entries relating to that aren't used.
227
# Also, server availability is done differently within autofs so the
228
# options that relate to the amd server monitoring sub-system are
229
# also not used.
230
#
231
# These options are mount_type, auto_attrcache, portmap_program,
232
# nfs_vers_ping, nfs_allow_any_interface, nfs_allow_insecure_port,
233
# nfs_proto, nfs_retransmit_counter, nfs_retransmit_counter_udp,
234
# nfs_retransmit_counter_tcp, nfs_retransmit_counter_toplvl,
235
# nfs_retry_interval, nfs_retry_interval_udp, nfs_retry_interval_tcp,
236
# nfs_retry_interval_toplvl and nfs_vers.
237
#
238
#
239
# Other options that are not used within the autofs implementation:
240
#
241
# log_file, truncate_log - autofs used either stderr when running in
242
#	the foreground or sends its output to syslog so an alternate
243
#	log file (or truncating the log) can't be used.
244
#
245
# print_pid - there's no corresponding option for this within autofs.
246
#
247
# use_tcpwrappers, show_statfs_entries - there's no user space NFS
248
#	server to control access to so this option isn't relevant.
249
#	The show_statfs_entries can't be implemented for the same
250
#	reason.
251
#
252
# debug_mtab_file - there's no user space NFS server and autofs
253
#	avoids using file based mtab whenever possible.
254
#
255
# sun_map_syntax - obviously, are provided by autofs itself.
256
#
257
# plock, show_statfs_entries, preferred_amq_port - not supported.
258
#
259
# ldap_cache_maxmem, ldap_cache_seconds - external ldap caching
260
#	is not used by autofs.
261
#
262
# ldap_proto_version - autofs always attempts to use the highest
263
#	available ldap protocol version.
264
#
265
# cache_duration, map_reload_interval, map_options - the map
266
#	entry cache is continually updated and stale entries
267
#	cleaned on re-load, which is done when map changes are
268
#	detected so these configuration entries are not used
269
#	by autofs.
270
#
271
# localhost_address - is not used within autofs. This
272
#	configuration option was only used in the amd user
273
#	space server code and is not relevant within autofs.
274
#
275
#
276
# Options that are handled differently within autofs:
277
#
278
# pid_file - must be given as a command line option on startup.
279
#
280
# print_version - program version and feature information is obtained
281
#	by using the automount command line option "-V".
282
#
283
# debug_options, log_options - autofs has somewhat more limited
284
#	logging and debug logging options. When the log_options
285
#	options is encountered it is converted to the nearest
286
#	matching autofs logging option. Since the configuration
287
#	option debug_options would be handled the same way it
288
#	is ignored.
289
#
290
# restart_mounts - has no sensible meaning within autofs because autofs
291
#	always tries to re-connect to existing mounts. While this
292
#	has its own set of problems not re-connecting to existing
293
#	mounts always results in a non-functional automount tree if
294
#	mounts were busy at the last shutdown (as is also the case
295
#	with amd when using mount_type autofs).
296
#
297
# forced_unmounts - detaching mounts often causes serious problems
298
#	for users of existing mounts. It is used by autofs in some
299
#	cases, either at the explicit request of the user (with a
300
#	command line or init option) and in some special cases during
301
#	program operation but is avoided whenever possible.
302
#
303
#
304
# A number of configuration options are not yet implemented:
305
#
306
# fully_qualified_hosts - not yet implemented.
307
#
308
# unmount_on_exit - since autofs always tries to re-connect
309
#	to mounts left mounted from a previous shutdown this
310
#	is a sensible option to implement and that will be
311
#	done.
312
#
313
# exec_map_timeout - a timeout is not currently used for
314
#	for program maps, might be implemented.
315
#
316
# tag - the tag option is not implemented within autofs.
317
#
318
#
319
# Supported options:
320
#
321
# arch, karch, os, osver - these options default to what is returned
322
#	from uname(2) and can be overridden if required.
323
#
324
# full_os - has no default and must be set in the configuration
325
#	if used in maps.
326
#
327
# cluster - if not set defaults to the host domain name. This option
328
#	corresponds to the HP_UX cluster name (according to the amd
329
#	source) and is probably not used in Linux but is set anyway.
330
#
331
# vendor - has a default value of "unknown", it must be set in the
332
#	configuration if used in maps.
333
#
334
# auto_dir - is the base name of the mount tree used for external
335
#	mounts that are sometimes needed by amd maps. Its default
336
#	value is "/a".
337
#
338
# map_type - specifies the autofs map source, such as file, nis,
339
#	ldap etc. and has no default value set.
340
#
341
# map_defaults - is used to override /defaults entries within maps
342
#	and can be used to provide different defaults on specific
343
#	machines without having to modify centrally managed maps.
344
#	It is empty by default.
345
#
346
# search_path - colon seperated paths to search for maps that
347
#	are not specified as a full path.
348
#
349
# dismount_interval - is equivalent to the autofs timeout option. It
350
#	is only possible to use this with type "auto" mounts due
351
#	to the way the autofs kernel module performs expiry. It
352
#	takes its default value from the autofs internal default
353
#	of 600 seconds.
354
#
355
# browsable_dirs - make map keys visible in directory listings.
356
#	Note that support for the "fullybrowsable" option cannot
357
#	be added using the existing kernel to user space autofs
358
#	implementation.
359
#
360
# autofs_use_lofs - if set to "yes" autofs will attempt to use bind
361
#	mounts for type "link" entries when possible.
362
#
363
# nis_domain - allows setting of a domain name other than the system
364
#	default.
365
#
366
# local_domain - is used to override (or set) the host domain name.
367
#
368
# normalize_hostnames - if set to "yes" then the contents of ${rhost}
369
#	is translated in its official host name.
370
#
371
# domain_strip - if set to "yes" the domain name part of the host
372
# 	is strippped when normalizing hostnames. This can be useful
373
#	when using of the same maps in a multiple domain environment.
374
#
375
# normalize_slashes - is set to "yes" by default and will collapse
376
#	multiple unescaped occurrences of "/" to a single "/".
377
#
378
# selectors_in_defaults, selectors_on_default - has a default value
379
#	of "no". If set to "yes" then any defaults entry will be
380
#	checked for selectors to determine the values to be used.
381
#	selectors_in_defaults is the preferred option to use.
382
#
383
# ldap_base - has no default value. It must be set to the base dn
384
#	that is used for queries if ldap is to be used as a map
385
#	source.
386
#
387
# ldap_hostports - has no default value set. It must be set to
388
#	the URI of the LDAP server to be used for lookups when
389
#	ldap is used a map source. It may contain a comma or
390
#	space seperated list of LDAP URIs.
391
#
392
# hesiod_base - the base name used for hesiod map sources.
393
#
394
# Additional configuration options added:
395
#
396
# linux_ufs_mount_type - set the default system filesystem type that's
397
#	used for mount type ufs. There's no simple way to determine
398
#	what the system default filesystem is and am-utils needs to
399
#	be continually updated to do this and can easily get it wrong
400
#	anyway.
401
#
402
#
403
# Define global options for the amd parser within autofs.
404
#
405
[ amd ]
406
#
407
# Override the internal default with the same timeout that
408
# is used by the override in the autofs configuration, sanity
409
# only change.
410
#
411
dismount_interval = 300
412
#
413
# map_type = file
414
#
415
# Overriding this can cause autofs to use less resources because
416
# it will use symlinks instead of bind mounts in certain cases.
417
# You should ensure that the autofs kernel module your using
418
# supports expration of symlinks for best results (although this
419
# appears to work reasonably well most of the time without the
420
# update).
421
#
422
# autofs_use_lofs = yes
423
#
424
# Several configuration options can be set per mount point.
425
# In particulr map_type, map_name, map_defaults, search_path,
426
# browsable_dirs, dismount_interval and selectors_in_defaults
427
# (not all of which are currently implemented, see above).
428
#
429
# Also, if a section for an amd mount point is defined here
430
# it isn't necessary to specify the format in the corresponding
431
# master map entry and the format will be inherited for type
432
# "auto" mounts.
433
#
434
# [ /expamle/mount ]
435
# dismount_interval = 60
436
# map_type = nis