diff options
Diffstat (limited to 'man/systemd.automount.xml')
| -rw-r--r-- | man/systemd.automount.xml | 173 |
1 files changed, 0 insertions, 173 deletions
diff --git a/man/systemd.automount.xml b/man/systemd.automount.xml deleted file mode 100644 index a43dc981bd..0000000000 --- a/man/systemd.automount.xml +++ /dev/null @@ -1,173 +0,0 @@ -<?xml version='1.0'?> <!--*-nxml-*--> -<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" - "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> - -<!-- - This file is part of systemd. - - Copyright 2010 Lennart Poettering - - systemd is free software; you can redistribute it and/or modify it - under the terms of the GNU Lesser General Public License as published by - the Free Software Foundation; either version 2.1 of the License, or - (at your option) any later version. - - systemd is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public License - along with systemd; If not, see <http://www.gnu.org/licenses/>. ---> - -<refentry id="systemd.automount"> - <refentryinfo> - <title>systemd.automount</title> - <productname>systemd</productname> - - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Lennart</firstname> - <surname>Poettering</surname> - <email>lennart@poettering.net</email> - </author> - </authorgroup> - </refentryinfo> - - <refmeta> - <refentrytitle>systemd.automount</refentrytitle> - <manvolnum>5</manvolnum> - </refmeta> - - <refnamediv> - <refname>systemd.automount</refname> - <refpurpose>Automount unit configuration</refpurpose> - </refnamediv> - - <refsynopsisdiv> - <para><filename><replaceable>automount</replaceable>.automount</filename></para> - </refsynopsisdiv> - - <refsect1> - <title>Description</title> - - <para>A unit configuration file whose name ends in - <literal>.automount</literal> encodes information about a file - system automount point controlled and supervised by - systemd.</para> - - <para>This man page lists the configuration options specific to - this unit type. See - <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry> - for the common options of all unit configuration files. The common - configuration items are configured in the generic [Unit] and - [Install] sections. The automount specific configuration options - are configured in the [Automount] section.</para> - - <para>Automount units must be named after the automount directories they control. Example: the automount point - <filename noindex='true'>/home/lennart</filename> must be configured in a unit file - <filename>home-lennart.automount</filename>. For details about the escaping logic used to convert a file system - path to a unit name see - <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>. Note that - automount units cannot be templated, nor is it possible to add multiple names to an automount unit by creating - additional symlinks to its unit file.</para> - - <para>For each automount unit file a matching mount unit file (see - <citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry> - for details) must exist which is activated when the automount path - is accessed. Example: if an automount unit - <filename>home-lennart.automount</filename> is active and the user - accesses <filename>/home/lennart</filename> the mount unit - <filename>home-lennart.mount</filename> will be activated.</para> - - <para>Automount units may be used to implement on-demand mounting - as well as parallelized mounting of file systems.</para> - </refsect1> - - <refsect1> - <title>Automatic Dependencies</title> - - <para>If an automount unit is beneath another mount unit in the - file system hierarchy, both a requirement and an ordering - dependency between both units are created automatically.</para> - - <para>An implicit <varname>Before=</varname> dependency is created - between an automount unit and the mount unit it activates.</para> - - <para>Automount units acquire automatic <varname>Before=</varname> and <varname>Conflicts=</varname> on - <filename>umount.target</filename> in order to be stopped during shutdown, unless - <varname>DefaultDependencies=no</varname> is set in the <literal>[Unit]</literal> section.</para> - - </refsect1> - - <refsect1> - <title><filename>fstab</filename></title> - - <para>Automount units may either be configured via unit files, or - via <filename>/etc/fstab</filename> (see - <citerefentry project='man-pages'><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry> - for details).</para> - - <para>For details how systemd parses - <filename>/etc/fstab</filename> see - <citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para> - - <para>If an automount point is configured in both - <filename>/etc/fstab</filename> and a unit file, the configuration - in the latter takes precedence.</para> - </refsect1> - - <refsect1> - <title>Options</title> - - <para>Automount files must include an [Automount] section, which - carries information about the file system automount points it - supervises. The options specific to the [Automount] section of - automount units are the following:</para> - - <variablelist class='unit-directives'> - - <varlistentry> - <term><varname>Where=</varname></term> - <listitem><para>Takes an absolute path of a directory of the - automount point. If the automount point does not exist at time - that the automount point is installed, it is created. This - string must be reflected in the unit filename. (See above.) - This option is mandatory.</para></listitem> - </varlistentry> - - <varlistentry> - <term><varname>DirectoryMode=</varname></term> - <listitem><para>Directories of automount points (and any - parent directories) are automatically created if needed. This - option specifies the file system access mode used when - creating these directories. Takes an access mode in octal - notation. Defaults to 0755.</para></listitem> - </varlistentry> - <varlistentry> - <term><varname>TimeoutIdleSec=</varname></term> - <listitem><para>Configures an idle timeout. Once the mount has been - idle for the specified time, systemd will attempt to unmount. Takes a - unit-less value in seconds, or a time span value such as "5min 20s". - Pass 0 to disable the timeout logic. The timeout is disabled by - default.</para></listitem> - </varlistentry> - </variablelist> - </refsect1> - - <refsect1> - <title>See Also</title> - <para> - <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, - <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>, - <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>, - <citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry>, - <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>, - <citerefentry project='die-net'><refentrytitle>automount</refentrytitle><manvolnum>8</manvolnum></citerefentry>, - <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry> - </para> - </refsect1> - -</refentry> |