266 lines
10 KiB
HTML
266 lines
10 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of AUTOMOUNT</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>AUTOMOUNT</H1>
|
|
Section: Maintenance Commands (8)<BR>Updated: 12 Apr 2006<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
automount - manage autofs mount points
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>automount</B> [<I>options</I>] [<I>master_map</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The <B>automount</B> program is used to manage mount points for
|
|
autofs, the inlined Linux automounter. <B>automount</B> works by
|
|
reading the
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+auto.master">auto.master</A></B>(5)
|
|
|
|
|
|
map and sets up mount points for each entry in the master map allowing
|
|
them to be automatically mounted when accessed. The file systems are
|
|
then automatically umounted after a period of inactivity.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><I>-h, --help</I>
|
|
|
|
<DD>
|
|
Print brief help on program usage.
|
|
<DT id="2"><I>-p, --pid-file</I>
|
|
|
|
<DD>
|
|
Write the pid of the daemon to the specified file.
|
|
<DT id="3"><I>-t <seconds>, --timeout <seconds></I>
|
|
|
|
<DD>
|
|
Set the global minimum timeout, in seconds, until directories
|
|
are unmounted. The default is 10 minutes. Setting the timeout
|
|
to zero disables umounts completely.
|
|
The internal program default is 10 minutes, but the default
|
|
installed configuration overrides this and sets the timeout
|
|
to 5 minutes to be consistent with earlier autofs releases.
|
|
<DT id="4"><I>-M <seconds>, --master-wait <seconds></I>
|
|
|
|
<DD>
|
|
Set the maximum time to wait for the master map to become available
|
|
if it cannot be read at program start.
|
|
<DT id="5"><I>-n <seconds>, --negative-timeout <seconds></I>
|
|
|
|
<DD>
|
|
Set the default timeout for caching failed key lookups. The default is 60 seconds.
|
|
<DT id="6"><I>-v, --verbose</I>
|
|
|
|
<DD>
|
|
Enables logging of general status and progress messages for all
|
|
autofs managed mounts.
|
|
<DT id="7"><I>-d, --debug</I>
|
|
|
|
<DD>
|
|
Enables logging of general status and progress messages as well as
|
|
debugging messages for all autofs managed mounts.
|
|
<DT id="8"><I>-Dvariable=value, --define variable=value</I>
|
|
|
|
<DD>
|
|
Define a global macro substitution variable. Global definitions
|
|
are over-ridden macro definitions of the same name specified in
|
|
mount entries.
|
|
<DT id="9"><I>-S, --systemd-service</I>
|
|
|
|
<DD>
|
|
Used when running the automounter as a systemd service to ensure log entry
|
|
format is consistent with the log entry format when running as a daemon.
|
|
<DT id="10"><I>-f, --foreground</I>
|
|
|
|
<DD>
|
|
Run the daemon in the foreground and log to stderr instead of syslog."
|
|
<DT id="11"><I>-r, --random-multimount-selection</I>
|
|
|
|
<DD>
|
|
Enables the use of random selection when choosing a host from a
|
|
list of replicated servers.
|
|
<DT id="12"><I>-m, --dumpmaps [<map type> <map name>]</I>
|
|
|
|
<DD>
|
|
With no parameters, list information about the configured automounter
|
|
maps, then exit.
|
|
<P>
|
|
If the dumpmaps option is given and is followed by two parameters,
|
|
"<map type> <map name>" then simple "<key, value>" pairs that would
|
|
be read in by a map read are printed to stdout if the given map type
|
|
and map name are found in the map configuration.
|
|
<P>
|
|
If the map is an LDAP map and there is more than one map of same name
|
|
in different base dns only the first map encountered by autofs will
|
|
be listed. Similarly, if the map is a file map and there is more than
|
|
one map of the same name in different directories, only the first map
|
|
encountered will be listed.
|
|
<P>
|
|
If the map type is an old style multi-map and any one of the map
|
|
names in the multi-map entry matches the given map name the entries
|
|
that would be used by autofs for the whole multi-map will be listed.
|
|
<DT id="13"><I>-O, --global-options</I>
|
|
|
|
<DD>
|
|
Allows the specification of global mount options used for all master
|
|
map entries. These options will either replace or be appended to options
|
|
given in a master map entry depending on the APPEND_OPTIONS configuration
|
|
setting.
|
|
<DT id="14"><I>-V, --version</I>
|
|
|
|
<DD>
|
|
Display the version number, then exit.
|
|
<DT id="15"><I>-l, --set-log-priority priority path [path,...]</I>
|
|
|
|
<DD>
|
|
Set the daemon log priority to the specified value. Valid values include
|
|
the numbers 0-7, or the strings emerg, alert, crit, err, warning, notice,
|
|
info, or debug. Log level debug will log everything, log levels info, warn
|
|
(or warning), or notice with enable the daemon verbose logging. Any other
|
|
level will set basic logging. Note that enabling debug or verbose
|
|
logging in the autofs global configuration will override dynamic log level
|
|
changes. For example, if verbose logging is set in the configuration then
|
|
attempting to set logging to basic logging, by using alert, crit, err
|
|
or emerg won't stop the verbose logging. However, setting logging to debug
|
|
will lead to everything (debug logging) being logged witch can then also
|
|
be disabled, returning the daemon to verbose logging. This option can be
|
|
specified to change the logging priority of an already running automount
|
|
process.
|
|
<P>
|
|
The <I>path</I> argument corresponds to the automounted
|
|
path name as specified in the master map.
|
|
<DT id="16"><I>-C, --dont-check-daemon</I>
|
|
|
|
<DD>
|
|
Don't check if the daemon is currently running (see NOTES).
|
|
<DT id="17"><I>-F, --force</I>
|
|
|
|
<DD>
|
|
Force an unlink umount of existing mounts under autofs managed mount points
|
|
during startup. This can cause problems for processes with working directories
|
|
within these mounts (see NOTES).
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ARGUMENTS</H2>
|
|
|
|
<B>automount</B> takes one optional argument, the name of the master map to
|
|
use.
|
|
<DL COMPACT>
|
|
<DT id="18"><B>master_map</B><DD>
|
|
Location for autofs master map that defines autofs managed mount points
|
|
and the mount maps they will use. The default is
|
|
|
|
<B>auto.master</B>.
|
|
|
|
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
If the <B>automount</B> daemon catches a USR1 signal, it will umount all
|
|
currently unused autofs managed mounted file systems and continue running
|
|
(forced expire). If it catches the TERM signal it will umount
|
|
all unused autofs managed mounted file systems and exit if there are
|
|
no remaining busy file systems. If autofs has been compiled with the
|
|
option to ignore busy mounts on exit it will exit leaving any busy
|
|
mounts in place otherwise busy file systems will not be umounted
|
|
and autofs will not exit.
|
|
Alternatively, if autofs has been compiled with the option to enable
|
|
forced shutdown then a USR2 signal to the daemon will cause all
|
|
mounts to be umounted and any busy mounts to be forcibly umounted,
|
|
including autofs mount point directories (summary execution). Note
|
|
that the forced umount is an unlink operation and the actual umount
|
|
will not happen in the kernel until active file handles are released.
|
|
The daemon also responds to a HUP signal which triggers an update of
|
|
the maps for each mount point.
|
|
<P>
|
|
|
|
If any autofs mount point directories are busy when the daemon is sent
|
|
an exit signal the daemon will not exit. The exception to this is
|
|
if autofs has been built with configure options to either ignore busy
|
|
mounts at exit or force umount at exit. If the ignore busy mounts at
|
|
exit option is used the filesystems will be left in a catatonic
|
|
(non-functional) state and can be manually umounted when they become
|
|
unused. If the force umount at exit option is used the filesystems
|
|
will be umounted but the mount will not be released by the kernel
|
|
until they are no longer in use by the processes that held them busy.
|
|
If automount managed filesystems are found mounted when autofs is
|
|
started they will be recovered unless they are no longer present in
|
|
the map in which case they need to umounted manually.
|
|
<P>
|
|
|
|
If the option to disable the check to see if the daemon is already
|
|
running is used be aware that autofs currently may not function correctly
|
|
for certain types of automount maps. The mounts of the separate daemons
|
|
might interfere with one another. The implications of running multiple
|
|
daemon instances needs to be checked and tested before we can say this
|
|
is supported.
|
|
<P>
|
|
|
|
If the option to force an unlink of mounts at startup is used then processes
|
|
whose working directory is within unlinked automounted directories will not
|
|
get the correct pwd from the system. This is because, after the mount is
|
|
unlinked from the mount tree, anything that needs to walk back up the mount
|
|
tree to construct a path, such as <A HREF="/cgi-bin/man/man2html?2+getcwd">getcwd</A>(2) and the proc filesystem
|
|
/proc/<pid>/cwd, cannot work because the point from which the path is
|
|
constructed has been detached from the mount tree.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+autofs">autofs</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+autofs">autofs</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+autofs.conf">autofs.conf</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+auto.master">auto.master</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mount">mount</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+autofs_ldap_auth.conf">autofs_ldap_auth.conf</A></B>(5).
|
|
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Don't know, I've fixed everything I know about.
|
|
<P>
|
|
The documentation could be better.
|
|
<P>
|
|
Please report other bugs along with a detailed description to
|
|
<<A HREF="mailto:autofs@vger.kernel.org">autofs@vger.kernel.org</A>>. Visit <A HREF="http://vger.kernel.org/vger-lists.html#autofs">http://vger.kernel.org/vger-lists.html#autofs</A>
|
|
for information about the list.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
H. Peter Anvin <<A HREF="mailto:hpa@transmeta.com">hpa@transmeta.com</A>> and Ian Kent <<A HREF="mailto:raven@themaw.net">raven@themaw.net</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="19"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="20"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="21"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="22"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="23"><A HREF="#lbAF">ARGUMENTS</A><DD>
|
|
<DT id="24"><A HREF="#lbAG">NOTES</A><DD>
|
|
<DT id="25"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="26"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="27"><A HREF="#lbAJ">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:11 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|