|
Packit |
8480eb |
.\" t
|
|
Packit |
8480eb |
.TH AUTOFS.CONF 5 "23 Jan 2014"
|
|
Packit |
8480eb |
.SH NAME
|
|
Packit |
8480eb |
autofs.conf \- autofs configuration
|
|
Packit |
8480eb |
.SH "DESCRIPTION"
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
Configuration settings used by
|
|
Packit |
8480eb |
.BR automount (8)
|
|
Packit |
8480eb |
may be changed in the configuration file \fB@@autofsmapdir@@/autofs.conf\fP.
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
This file contains two primary sections, \fBautofs\fP and \fBamd\fP.
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
Configuration entries may be present at the beginning of the
|
|
Packit |
8480eb |
configuration file without a section header and are implicitly
|
|
Packit |
8480eb |
included as part of the \fBautofs\fP section.
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
Each section name is enclosed in square brackets with
|
|
Packit |
8480eb |
spaces between the brackets and the section name. The \fBamd\fP
|
|
Packit |
8480eb |
section may be followed by further sections, named by the
|
|
Packit |
8480eb |
top level mount point path, that contain per mount
|
|
Packit |
8480eb |
configuration settings.
|
|
Packit |
8480eb |
.SH "SECTION autofs CONFIGURATION OPTIONS"
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
Configuration settings available are:
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B timeout
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Sets the default mount timeout in seconds. The internal program
|
|
Packit |
8480eb |
default is 10 minutes, but the default installed configuration
|
|
Packit |
8480eb |
overrides this and sets the timeout to 5 minutes to be consistent
|
|
Packit |
8480eb |
with earlier autofs releases.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B master_wait
|
|
Packit |
8480eb |
sets the default maximum time to wait for the master map to become
|
|
Packit |
8480eb |
available if it cannot be read at program start (program default 10,
|
|
Packit |
8480eb |
wait for 10 seconds then continue).
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B negative_timeout
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Set the default timeout for caching failed key lookups (program default
|
|
Packit |
8480eb |
60). If the equivalent command line option is given it will override this
|
|
Packit |
8480eb |
setting.
|
|
Packit |
8480eb |
.TP
|
|
Packit Service |
9cc309 |
.B mount_verbose
|
|
Packit Service |
9cc309 |
.br
|
|
Packit Service |
888ac8 |
Use the verbose flag when spawning mount(8), and log some process info
|
|
Packit Service |
888ac8 |
about the requestor and its parent (program default "no").
|
|
Packit Service |
9cc309 |
.TP
|
|
Packit |
8480eb |
.B mount_wait
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Set the default time to wait for a response from a spawned mount(8)
|
|
Packit |
8480eb |
before sending it a SIGTERM. Note that we still need to wait for the
|
|
Packit |
8480eb |
RPC layer to timeout before the sub-process exits so this isn't ideal
|
|
Packit |
8480eb |
but it is the best we can do. The default is to wait until mount(8)
|
|
Packit |
8480eb |
returns without intervention.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B umount_wait
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Set the default time to wait for a response from a spawned umount(8)
|
|
Packit |
8480eb |
before sending it a SIGTERM. Note that we still need to wait for the
|
|
Packit |
8480eb |
RPC layer to timeout before the sub-process exits so this isn't ideal
|
|
Packit |
8480eb |
but it is the best we can do.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B browse_mode
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Maps are browsable by default (program default "yes").
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B mount_nfs_default_protocol
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Set the default protocol that
|
|
Packit |
8480eb |
.BR mount.nfs (8)
|
|
Packit |
8480eb |
uses when performing a mount (program default 3). Autofs needs to know
|
|
Packit |
8480eb |
the default NFS protocol that
|
|
Packit |
8480eb |
.BR mount.nfs(8)
|
|
Packit |
8480eb |
uses so it can do special case handling for its availability probe for
|
|
Packit |
8480eb |
different NFS protocols. Since we can't identify this default
|
|
Packit |
8480eb |
automatically we need to set it in the autofs configuration.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B append_options
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Determine whether global options, given on the command line or per mount
|
|
Packit |
8480eb |
in the master map, are appended to map entry options or if the map entry
|
|
Packit |
8480eb |
options replace the global options (program default "yes", append options).
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B logging
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
set default log level "none", "verbose" or "debug" (program default "none").
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B force_standard_program_map_env
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
override the use of a prefix with standard environment variables when a
|
|
Packit |
8480eb |
program map is executed. Since program maps are run as the privileded
|
|
Packit |
8480eb |
user setting these standard environment variables opens automount(8) to
|
|
Packit |
8480eb |
potential user privilege escalation when the program map is written in a
|
|
Packit |
8480eb |
language that can load components from, for example, a user home directory
|
|
Packit |
8480eb |
(program default "no").
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B map_hash_table_size
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
This configuration option may be used to change the number of hash
|
|
Packit |
8480eb |
table slots (default 1024).
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
This configuration option affects the overhead of searching the map
|
|
Packit |
8480eb |
entry cache for map entries when there are a large number of entries.
|
|
Packit |
8480eb |
It affects the number of entries that must be looked at to locate a
|
|
Packit |
8480eb |
map entry in the map entry cache. For example, the default of 1024
|
|
Packit |
8480eb |
and a direct map with 8000 entries would result in each slot
|
|
Packit |
8480eb |
containing an average of 8 entries, which should be acceptable.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
However, if excessive CPU usage is observed during automount lookups
|
|
Packit |
8480eb |
increasing this option can reduce the CPU overhead considerably becuase
|
|
Packit |
8480eb |
it reduces the length of the search chains.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
Note that the number of entries in a map doesn't necessarily relate
|
|
Packit |
8480eb |
to the number of entries used in the map entry cache.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
There are three distinct cases, direct maps and indirect maps that
|
|
Packit |
8480eb |
use the "browse" option must be read in their entirity at program
|
|
Packit |
8480eb |
start so, in these two cases the map size does retate directly to
|
|
Packit |
8480eb |
the map entry cache size.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
For indirect maps that do not use the "browse" option entries are
|
|
Packit |
8480eb |
added to the map entry cache at lookup so the number of active cache
|
|
Packit |
8480eb |
entries, in this case, is usually much less than the number of entries
|
|
Packit |
8480eb |
in the map. In this last case it would be unusual for the map entry
|
|
Packit |
8480eb |
cache to grow large enough to warrant increasing the default before
|
|
Packit |
8480eb |
an event that cleans stale entries, a map re-read for example.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B use_hostname_for_mounts
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
NFS mounts where the host name resolves to more than one IP address
|
|
Packit |
8480eb |
are probed for availability and to establish the order in which mounts
|
|
Packit |
8480eb |
to them should be tried. To ensure that mount attempts are made only
|
|
Packit |
8480eb |
to hosts that are responding and are tried in the order of hosts with
|
|
Packit |
8480eb |
the quickest response the IP address of the host needs to be used for
|
|
Packit |
8480eb |
the mount.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
If it is necessary to use the hostname given in the map entry for the
|
|
Packit |
8480eb |
mount regardless, then set this option to "yes".
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
Be aware that if this is done there is no defense against the host
|
|
Packit |
8480eb |
name resolving to one that isn't responding and while the number
|
|
Packit |
8480eb |
of attempts at a successful mount will correspond to the number of
|
|
Packit |
8480eb |
addresses the host name resolves to the order will also not correspond
|
|
Packit |
8480eb |
to fastest responding hosts.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B disable_not_found_message
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The original request to add this log message needed it to be unconditional.
|
|
Packit |
8480eb |
That produces, IMHO, unnecessary noise in the log so a configuration option
|
|
Packit |
8480eb |
has been added to provide the ability to turn it off. The default is "no"
|
|
Packit |
8480eb |
to maintain the current behaviour.
|
|
Packit |
8480eb |
.TP
|
|
Packit Service |
6247e7 |
.B use_ignore_mount_option
|
|
Packit Service |
6247e7 |
.br
|
|
Packit Service |
6247e7 |
An option to enable the use of autofs pseudo option "disable". This option
|
|
Packit Service |
6247e7 |
is used as a hint to user space that the mount entry should be ommitted from
|
|
Packit Service |
6247e7 |
mount table listings. The default is "no" to avoid unexpected changes in
|
|
Packit Service |
6247e7 |
behaviour and so is an opt-in setting.
|
|
Packit Service |
6247e7 |
.TP
|
|
Packit |
8480eb |
.B sss_master_map_wait
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Set the time to wait and retry if sssd returns "no such entry" when starting
|
|
Packit |
8480eb |
up. When sssd is starting up it can sometimes return "no such entry" for a
|
|
Packit |
8480eb |
short time until it has read in the LDAP map information. Default is 0 seconds,
|
|
Packit |
8480eb |
don't wait.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B use_mount_request_log_id
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Set whether to use a mount request log id so that log entries for specific
|
|
Packit |
8480eb |
mount requests can be easily identified in logs that have multiple conncurrent
|
|
Packit |
8480eb |
requests. Default is don't use mount request log ids.
|
|
Packit |
8480eb |
.SS LDAP Configuration
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
Configuration settings available are:
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B ldap_timeout
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Set the network response timeout (default 8).
|
|
Packit |
8480eb |
Set timeout value for the synchronous API calls. The default is the LDAP
|
|
Packit |
8480eb |
library default of an infinite timeout.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B ldap_network_timeout
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Set the network response timeout (default 8).
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B ldap_uri
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
A space separated list of server uris of the form <proto>://<server>[/]
|
|
Packit |
8480eb |
where <proto> can be ldap or ldaps. The option can be given multiple times.
|
|
Packit |
8480eb |
Map entries that include a server name override this option and it is then
|
|
Packit |
8480eb |
not used. Default is an empty list in which case either the server given
|
|
Packit |
8480eb |
in a map entry or the LDAP configured default is used. This uri list is read at
|
|
Packit |
8480eb |
startup and whenever the daemon receives a HUP signal.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
This configuration option can also be used to request autofs lookup SRV RRs
|
|
Packit |
8480eb |
for a domain of the form <proto>:///[<domain dn>]. Note that a trailing
|
|
Packit |
8480eb |
"/" is not allowed when using this form. If the domain dn is not specified
|
|
Packit |
8480eb |
the dns domain name (if any) is used to construct the domain dn for the
|
|
Packit |
8480eb |
SRV RR lookup. The server list returned from an SRV RR lookup is refreshed
|
|
Packit |
8480eb |
according to the minimum ttl found in the SRV RR records or after one hour,
|
|
Packit |
8480eb |
whichever is less.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B search_base
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The base dn to use when searching for amap base dn. This entry may be
|
|
Packit |
8480eb |
given multiple times and each will be checked for a map base dn in
|
|
Packit |
8480eb |
the order they occur in the configuration. The search base list is read
|
|
Packit |
8480eb |
at startup and whenever the daemon recieves a HUP signal.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B map_object_class
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The map object class. In the \fBnisMap\fP schema this corresponds to the class
|
|
Packit |
8480eb |
\fBnisMap\fP and in the \fBautomountMap\fP schema it corresponds to the class
|
|
Packit |
8480eb |
\fBautomountMap\fP.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B entry_object_class
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The map entry object class. In the \fBnisMap\fP schema this corresponds
|
|
Packit |
8480eb |
to the class \fBnisObject\fP and in the \fBautomountMap\fP schema it
|
|
Packit |
8480eb |
corresponds to the class \fBautomount\fP.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B map_attribute
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The attribute used to identify the name of the map to which this
|
|
Packit |
8480eb |
entry belongs. In the \fBnisMap\fP schema this corresponds to the attribute
|
|
Packit |
8480eb |
\fBnisMapName\fP and in the \fBautomountMap\fP schema it corresponds to the
|
|
Packit |
8480eb |
attribute \fBou\fP or \fBautomountMapName\fP.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B entry_attribute
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The attribute used to identify a map key. In the \fBnisMap\fP schema this
|
|
Packit |
8480eb |
corresponds to the attribute \fBcn\fP and in the \fBautomountMap\fP schema
|
|
Packit |
8480eb |
it corresponds to the attribute \fBautomountKey\fP.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B value_attribute
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The attribute used to identify the value of the map entry. In the \fBnisMap\fP
|
|
Packit |
8480eb |
schema this corresponds to the attribute \fBnisMapEntry\fP and in the \fBautomountMap\fP
|
|
Packit |
8480eb |
schema it corresponds to the attribute
|
|
Packit |
8480eb |
.BR automountInformation .
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B NOTE:
|
|
Packit |
8480eb |
It is essential that entries use class and attribute in a consistent
|
|
Packit |
8480eb |
manner for correct operation of autofs. For example mixing \fBcn\fP
|
|
Packit |
8480eb |
and \fBautomountKey\fP attributes in \fBautomount\fP schema will
|
|
Packit |
8480eb |
not work as expected.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B auth_conf_file
|
|
Packit |
8480eb |
This configuration option may be used to specify an alternate location
|
|
Packit |
8480eb |
for the ldap authentication configuration file. See
|
|
Packit |
8480eb |
.BR autofs_ldap_auth.conf (5)
|
|
Packit |
8480eb |
for more information.
|
|
Packit |
8480eb |
.SH "SECTION amd CONFIGURATION OPTIONS"
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
A number of the amd configuration options are not used by autofs,
|
|
Packit |
8480eb |
some because they are not relevant within autofs, some because
|
|
Packit |
8480eb |
they are done differently in autofs and others that are not yet
|
|
Packit |
8480eb |
implemented.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
Since \fBmount_type\fP is always autofs (because there's no user space
|
|
Packit |
8480eb |
NFS server) the configuration entries relating to that aren't used.
|
|
Packit |
8480eb |
Also, server availability is done differently within autofs so the
|
|
Packit |
8480eb |
options that relate to the amd server monitoring sub-system are
|
|
Packit |
8480eb |
also not used.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
These options are \fBmount_type\fP, \fBauto_attrcache\fP, \fBportmap_program\fP,
|
|
Packit |
8480eb |
\fBnfs_vers_ping\fP, \fBnfs_allow_any_interface\fP, \fBnfs_allow_insecure_port\fP,
|
|
Packit |
8480eb |
\fBnfs_proto\fP, \fBnfs_retransmit_counter\fP, \fBnfs_retransmit_counter_udp\fP,
|
|
Packit |
8480eb |
\fBnfs_retransmit_counter_tcp\fP, \fBnfs_retransmit_counter_toplvl\fP,
|
|
Packit |
8480eb |
\fBnfs_retry_interval\fP, \fBnfs_retry_interval_udp\fP, \fBnfs_retry_interval_tcp\fP,
|
|
Packit |
8480eb |
\fBnfs_retry_interval_toplvl\fP and \fBnfs_vers\fP.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
Other options that are not used within the autofs implementation:
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.BR log_file ", " truncate_log
|
|
Packit |
8480eb |
.br autofs used either stderr when running in the foreground or
|
|
Packit |
8480eb |
sends its output to syslog so an alternate log file (or truncating
|
|
Packit |
8480eb |
the log) can't be used.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B print_pid
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
There's no corresponding option for this within autofs.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.BR use_tcpwrappers ", " show_statfs_entries
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
There's no user space NFS server to control access to so this
|
|
Packit |
8480eb |
option isn't relevant. The show_statfs_entries can't be
|
|
Packit |
8480eb |
implemented for the same reason.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B debug_mtab_file
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
There's no user space NFS server and autofs avoids using file
|
|
Packit |
8480eb |
based mtab whenever possible.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B sun_map_syntax
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Sun map format is handled by autofs itself.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.BR plock ", " show_statfs_entries ", " preferred_amq_port
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Are not supported by autofs.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.BR ldap_cache_maxmem ", " ldap_cache_seconds
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
External ldap caching is not used by autofs.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B ldap_proto_version
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
autofs always attempts to use the highest available ldap
|
|
Packit |
8480eb |
protocol version.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.BR cache_duration ", " map_reload_interval ", " map_options
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The map entry cache is continually updated and stale entries
|
|
Packit |
8480eb |
cleaned on re-load, which is done when map changes are detected
|
|
Packit |
8480eb |
so these configuration entries are not used by autofs. An
|
|
Packit |
8480eb |
exception to this is the case where the map is large. In this
|
|
Packit |
8480eb |
case it may be necessary to read the whole map at startup even if
|
|
Packit |
8480eb |
browsing is is not enabled. Adding the cache:=all option to
|
|
Packit |
8480eb |
map_options can be used to for this.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B localhost_address
|
|
Packit |
8480eb |
This is not used within autofs. This configuration option was
|
|
Packit |
8480eb |
only used in the amd user space server code and is not relevant
|
|
Packit |
8480eb |
within autofs.
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
Options that are handled differently within autofs:
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B pid_file
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
To specify a pid file name a command line option must be used on startup.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B print_version
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Program version and feature information is obtained by using the
|
|
Packit |
8480eb |
automount command line option "-V".
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B debug_options ", " log_options
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
autofs has somewhat more limited logging and debug logging options.
|
|
Packit |
8480eb |
When the log_options options is encountered it is converted to the
|
|
Packit |
8480eb |
nearest matching autofs logging option. Since the configuration
|
|
Packit |
8480eb |
option debug_options would be handled the same way it is ignored.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B restart_mounts
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
This option has no sensible meaning within autofs because autofs
|
|
Packit |
8480eb |
always tries to re-connect to existing mounts. While this has its
|
|
Packit |
8480eb |
own set of problems not re-connecting to existing mounts always
|
|
Packit |
8480eb |
results in a non-functional automount tree if mounts were busy at
|
|
Packit |
8480eb |
the last shutdown (as is also the case with amd when using
|
|
Packit |
8480eb |
mount_type autofs).
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B forced_unmounts
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Detaching mounts often causes serious problems for users of
|
|
Packit |
8480eb |
existing mounts. It is used by autofs in some cases, either at
|
|
Packit |
8480eb |
the explicit request of the user (with a command line or init
|
|
Packit |
8480eb |
option) and in some special cases during program operation but
|
|
Packit |
8480eb |
is avoided whenever possible.
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
A number of configuration options are not yet implemented:
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B search_path
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Always a little frustrating, the compiled in map location should
|
|
Packit |
8480eb |
be used to locate maps but isn't in some cases. This requires
|
|
Packit |
8480eb |
work within autofs itself and that will (obviously) include
|
|
Packit |
8480eb |
implementing this configuration option for the amd map parser
|
|
Packit |
8480eb |
as well.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B fully_qualified_hosts
|
|
Packit |
8480eb |
Not yet implemented.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B unmount_on_exit
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Since autofs always tries to re-connect to mounts left mounted
|
|
Packit |
8480eb |
from a previous shutdown this is a sensible option to implement
|
|
Packit |
8480eb |
and that will be done.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B browsable_dirs
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Allow map keys to be shown in directory listings. This option
|
|
Packit |
8480eb |
can have values of "yes" or "no". The default is "no". A variation
|
|
Packit |
8480eb |
of this option, "browsable", can be used as a pseudo mount option
|
|
Packit |
8480eb |
in type "auto" map entries to provide provide browsing funtionality
|
|
Packit |
8480eb |
in sub-mounts. The amd "browsable_dirs = full" option cannot be
|
|
Packit |
8480eb |
implemented within the current autofs framework and is not supported.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B exec_map_timeout
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
A timeout is not currently used for for program maps, might be
|
|
Packit |
8480eb |
implemented.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B tag
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
The tag option is not implemented within autofs.
|
|
Packit |
8480eb |
.P
|
|
Packit |
8480eb |
Supported options:
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.BR arch ", " karch ", " os ", " osver
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
These options default to what is returned from uname(2) and can
|
|
Packit |
8480eb |
be overridden if required.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B full_os
|
|
Packit |
8480eb |
This option has no default and must be set in the configuration
|
|
Packit |
8480eb |
if used in maps.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B cluster
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
If not set defaults to the host domain name. This option corresponds
|
|
Packit |
8480eb |
to the HP_UX cluster name (according to the amd source) and is
|
|
Packit |
8480eb |
probably not used in Linux but is set anyway.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B vendor
|
|
Packit |
8480eb |
This option has a default value of "unknown", it must be set in the
|
|
Packit |
8480eb |
configuration if used in maps.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B auto_dir
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Is the base name of the mount tree used for external mounts that
|
|
Packit |
8480eb |
are sometimes needed by amd maps. Its default value is "/a".
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B map_type
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Specifies the autofs map source, such as file, nis, ldap etc. and
|
|
Packit |
8480eb |
has no default value set.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B map_defaults
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
This option is used to override /defaults entries within maps
|
|
Packit |
8480eb |
and can be used to provide different defaults on specific machines
|
|
Packit |
8480eb |
without having to modify centrally managed maps. It is empty by
|
|
Packit |
8480eb |
default.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B search_path
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Colon separated paths to search for maps that are not specified
|
|
Packit |
8480eb |
as a full path.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B dismount_interval
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Is equivalent to the autofs timeout option. It is only possible
|
|
Packit |
8480eb |
to use this with type "auto" mounts due to the way the autofs
|
|
Packit |
8480eb |
kernel module performs expiry. It takes its default value from
|
|
Packit |
8480eb |
the autofs internal default of 600 seconds.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B autofs_use_lofs
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
If set to "yes" autofs will attempt to use bind mounts for type
|
|
Packit |
8480eb |
"link" entries when possible (default is "yes").
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B nis_domain
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Allows setting of a domain name other than the system default.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B local_domain
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Is used to override (or set) the host domain name.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B normalize_hostnames
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
If set to "yes" then the contents of ${rhost} is translated in
|
|
Packit |
8480eb |
its official host name.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B domain_strip
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
If set to "yes" the domain name part of the host is strippped
|
|
Packit |
8480eb |
when normalizing hostnames. This can be useful when using of
|
|
Packit |
8480eb |
the same maps in a multiple domain environment.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B normalize_slashes
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
This option is set to "yes" by default and will collapse
|
|
Packit |
8480eb |
multiple unescaped occurrences of "/" to a single "/".
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.BR selectors_in_defaults ", " selectors_on_default
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
This option has a default value of "no". If set to "yes" then
|
|
Packit |
8480eb |
any defaults entry will be checked for selectors to determine
|
|
Packit |
8480eb |
the values to be used. selectors_in_defaults is the preferred
|
|
Packit |
8480eb |
option to use.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B ldap_base
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
iThis option has no default value. It must be set to the base dn
|
|
Packit |
8480eb |
that is used for queries if ldap is to be used as a map source.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B ldap_hostports
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
This option has no default value set. It must be set to the URI
|
|
Packit |
8480eb |
of the LDAP server to be used for lookups wheni ldap is used a
|
|
Packit |
8480eb |
map source. It may contain a comma or space separated list of
|
|
Packit |
8480eb |
LDAP URIs.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B hesiod_base
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
Sets the base name used for hesiod map sources.
|
|
Packit |
8480eb |
.TP
|
|
Packit |
8480eb |
.B linux_ufs_mount_type
|
|
Packit |
8480eb |
.br
|
|
Packit |
8480eb |
This is an additional configuration option for the autofs amd format
|
|
Packit |
8480eb |
parser implementation.
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
There's no simple way to determine what the system default filesystem
|
|
Packit |
8480eb |
is and am-utils needs to be continually updated to do this and can
|
|
Packit |
8480eb |
easily get it wrong ayway. So allow it to be set in the configuration.
|
|
Packit |
8480eb |
.SH EXAMPLE
|
|
Packit |
8480eb |
.sp
|
|
Packit |
8480eb |
.RS +.2i
|
|
Packit |
8480eb |
.ta 1.0i
|
|
Packit |
8480eb |
.nf
|
|
Packit |
8480eb |
[ autofs ]
|
|
Packit |
8480eb |
timeout = 300
|
|
Packit |
8480eb |
browse_mode = no
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
[ amd ]
|
|
Packit |
8480eb |
dismount_interval = 300
|
|
Packit |
8480eb |
map_type = nis
|
|
Packit |
8480eb |
autofs_use_lofs = no
|
|
Packit |
8480eb |
|
|
Packit |
8480eb |
[ /expamle/mount ]
|
|
Packit |
8480eb |
dismount_interval = 60
|
|
Packit |
8480eb |
map_type = file
|
|
Packit |
8480eb |
.fi
|
|
Packit |
8480eb |
.RE
|
|
Packit |
8480eb |
.SH "SEE ALSO"
|
|
Packit |
8480eb |
.BR automount (8),
|
|
Packit |
8480eb |
.BR auto.master (5),
|
|
Packit |
8480eb |
.BR autofs_ldap_auth.conf (5).
|
|
Packit |
8480eb |
.SH AUTHOR
|
|
Packit |
8480eb |
This manual page was written by Ian Kent <raven@themaw.net>.
|