cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering This file is part of systemd.
cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering Copyright 2010 Lennart Poettering
cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering systemd is free software; you can redistribute it and/or modify it
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering under the terms of the GNU Lesser General Public License as published by
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering the Free Software Foundation; either version 2.1 of the License, or
cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering (at your option) any later version.
cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering systemd is distributed in the hope that it will be useful, but
cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering Lesser General Public License for more details.
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering You should have received a copy of the GNU Lesser General Public License
cdb788e4cdc67bf7da6b3b1b3f4f295ef5c25c67Lennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <email>lennart@poettering.net</email>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd.mount</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>systemd.mount</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Mount unit configuration</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename><replaceable>mount</replaceable>.mount</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A unit configuration file whose name ends in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>.mount</literal> encodes information about a file system
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek mount point controlled and supervised by systemd.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>This man page lists the configuration options specific to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek this unit type. See
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for the common options of all unit configuration files. The common
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configuration items are configured in the generic [Unit] and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek [Install] sections. The mount specific configuration options are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configured in the [Mount] section.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Additional options are listed in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek which define the execution environment the
3ba3a79df4ae094d1008c04a9af8d1ff970124c4Zbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek binary is executed in, and in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek which define the way the processes are terminated, and in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek which configure resource control settings for the processes of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek service. Note that the User= and Group= options are not
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek particularly useful for mount units specifying a
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>Type=</literal> option or using configuration not
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek specified in <filename>/etc/fstab</filename>;
3ba3a79df4ae094d1008c04a9af8d1ff970124c4Zbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek will refuse options that are not listed in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc/fstab</filename> if it is not run as UID 0.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Mount units must be named after the mount point directories
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek they control. Example: the mount point
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename noindex='true'>/home/lennart</filename> must be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configured in a unit file <filename>home-lennart.mount</filename>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek For details about the escaping logic used to convert a file system
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek path to a unit name, see
cc8454d522315d149d491ffd1e688849883a0ea5Nicolas Cornu <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
cc8454d522315d149d491ffd1e688849883a0ea5Nicolas Cornu Note that mount units cannot be templated.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Optionally, a mount unit may be accompanied by an automount
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek unit, to allow on-demand or parallelized mounting. See
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.automount</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Mount points created at runtime (independently of unit files
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek or <filename>/etc/fstab</filename>) will be monitored by systemd
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek and appear like any other mount unit in systemd. See
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/proc/self/mountinfo</filename> description in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>proc</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Some file systems have special semantics as API file systems
ff9b60f38bf68eba4a47cabff14547d92e083214Torstein Husebø for kernel-to-userspace and userspace-to-userspace interfaces. Some
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek of them may not be changed via mount units, and cannot be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek disabled. For a longer discussion see <ulink
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek url="http://www.freedesktop.org/wiki/Software/systemd/APIFileSystems">API
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <para>If a mount unit is beneath another mount unit in the file
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering system hierarchy, both a requirement dependency and an ordering
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering dependency between both units are created automatically.</para>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <para>Block device backed file systems automatically gain
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <varname>BindsTo=</varname> and <varname>After=</varname> type
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering dependencies on the device unit encapsulating the block
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering device (see below).</para>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <para>If traditional file system quota is enabled for a mount
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering unit, automatic <varname>Wants=</varname> and
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <varname>Before=</varname> dependencies on
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <filename>systemd-quotacheck.service</filename> and
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <filename>quotaon.service</filename> are added.</para>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <para>For mount units with
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <varname>DefaultDependencies=yes</varname> (the default) a couple
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering additional dependencies are added. Mount units referring to local
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering file systems automatically gain an <varname>After=</varname>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering dependency on <filename>local-fs-pre.target</filename>. Network
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering mount units automatically acquire <varname>After=</varname>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering dependencies on <filename>remote-fs-pre.target</filename>,
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <filename>network-online.target</filename>. Towards the latter a
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <varname>Wants=</varname> unit is added as well. Mount units
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering referring to local and network file systems are distinguished by
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering their file system type specification. In some cases this is not
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering sufficient (for example network block device based mounts, such as
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering iSCSI), in which case <option>_netdev</option> may be added to the
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering mount option string of the unit, which forces systemd to consider the
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering mount unit a network mount. Mount units (regardless if local or
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering network) also acquire automatic <varname>Before=</varname> and
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <filename>umount.target</filename> in order to be stopped
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering during shutdown.</para>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <para>Additional implicit dependencies may be added as result of
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering execution and resource control parameters as documented in
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title><filename>fstab</filename></title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Mount units may either be configured via unit files, or via
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc/fstab</filename> (see
3ba3a79df4ae094d1008c04a9af8d1ff970124c4Zbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details). Mounts listed in <filename>/etc/fstab</filename>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek will be converted into native units dynamically at boot and when
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the configuration of the system manager is reloaded. In general,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configuring mount points through <filename>/etc/fstab</filename>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek is the preferred approach. See
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details about the conversion.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>When reading <filename>/etc/fstab</filename> a few special
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek mount options are understood by systemd which influence how
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek dependencies are created for mount points. systemd will create a
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering dependency of type <varname>Wants=</varname> or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <option>Requires</option> (see option <option>nofail</option>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek below), from either <filename>local-fs.target</filename> or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>remote-fs.target</filename>, depending whether the file
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek system is local or remote.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='fstab-options'>
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak <varlistentry>
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak <listitem><para>Configures a <varname>Requires=</varname> and
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak an <varname>After=</varname> dependency between the created
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak mount unit and another systemd unit, such as a device or mount
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak unit. The argument should be a unit name, or an absolute path
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak to a device node or mount point. This option may be specified
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak more than once. This option is particularly useful for mount
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak point declarations that need an additional device to be around
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak (such as an external journal device for journal file systems)
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak or an additional mount to be in place (such as an overlay file
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak system that merges multiple mount points). See
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak <varname>After=</varname> and <varname>Requires=</varname> in
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak </varlistentry>
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak <varlistentry>
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak <term><option>x-systemd.requires-mounts-for=</option></term>
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak <varname>RequiresMountsFor=</varname> dependency between the
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak created mount unit and other mount units. The argument must be
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak an absolute path. This option may be specified more than once.
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
3519d230c8bafe834b2dac26ace49fcfba139823Karel Zak </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><option>x-systemd.automount</option></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>An automount unit will be created for the file
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.automount</refentrytitle><manvolnum>5</manvolnum></citerefentry>
deb0a77cf0b409141c4b116ae30becb3d878e1adMichael Olbrich <varlistentry>
deb0a77cf0b409141c4b116ae30becb3d878e1adMichael Olbrich <term><option>x-systemd.idle-timeout=</option></term>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <listitem><para>Configures the idle timeout of the
deb0a77cf0b409141c4b116ae30becb3d878e1adMichael Olbrich automount unit. See <varname>TimeoutIdleSec=</varname> in
deb0a77cf0b409141c4b116ae30becb3d878e1adMichael Olbrich <citerefentry><refentrytitle>systemd.automount</refentrytitle><manvolnum>5</manvolnum></citerefentry>
deb0a77cf0b409141c4b116ae30becb3d878e1adMichael Olbrich </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><option>x-systemd.device-timeout=</option></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Configure how long systemd should wait for a
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek device to show up before giving up on an entry from
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc/fstab</filename>. Specify a time in seconds or
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt explicitly append a unit such as <literal>s</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>min</literal>, <literal>h</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Note that this option can only be used in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc/fstab</filename>, and will be
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt ignored when part of the <varname>Options=</varname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek setting in a unit file.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><option>noauto</option></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><option>auto</option></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>With <option>noauto</option>, this mount will
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek not be added as a dependency for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>local-fs.target</filename> or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>remote-fs.target</filename>. This means that it will
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek not be mounted automatically during boot, unless it is pulled
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt in by some other unit. The <option>auto</option> option has the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek opposite meaning and is the default.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><option>nofail</option></term>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <listitem><para>With <option>nofail</option>, this mount will
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek be only wanted, not required, by
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>local-fs.target</filename> or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>remote-fs.target</filename>. This means that the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek boot will continue even if this mount point is not mounted
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek successfully.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><option>x-initrd.mount</option></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>An additional filesystem to be mounted in the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek initramfs. See <filename>initrd-fs.target</filename>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>If a mount point is configured in both
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc/fstab</filename> and a unit file that is stored
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek below <filename>/usr</filename>, the former will take precedence.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek If the unit file is stored below <filename>/etc</filename>, it
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek will take precedence. This means: native unit files take
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek precedence over traditional configuration files, but this is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek superseded by the rule that configuration in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc</filename> will always take precedence over
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configuration in <filename>/usr</filename>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Mount files must include a [Mount] section, which carries
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek information about the file system mount points it supervises. A
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek number of options that may be used in this section are shared with
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek other unit types. These options are documented in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek The options specific to the [Mount] section of mount units are the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek following:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='unit-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>What=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Takes an absolute path of a device node, file
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek or other resource to mount. See
3ba3a79df4ae094d1008c04a9af8d1ff970124c4Zbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details. If this refers to a device node, a dependency on
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the respective device unit is automatically created. (See
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.device</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for more information.) This option is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Where=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Takes an absolute path of a directory of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek mount point. If the mount point does not exist at the time of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek mounting, it is created. This string must be reflected in the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek unit filename. (See above.) This option is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Type=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Takes a string for the file system type. See
3ba3a79df4ae094d1008c04a9af8d1ff970124c4Zbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details. This setting is optional.</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Options=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Mount options to use when mounting. This takes
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek a comma-separated list of options. This setting is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>SloppyOptions=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Takes a boolean argument. If true, parsing of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the options specified in <varname>Options=</varname> is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek relaxed, and unknown mount options are tolerated. This
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek corresponds with
3ba3a79df4ae094d1008c04a9af8d1ff970124c4Zbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>'s
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <parameter>-s</parameter> switch. Defaults to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>DirectoryMode=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Directories of mount points (and any parent
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek directories) are automatically created if needed. This option
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek specifies the file system access mode used when creating these
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek directories. Takes an access mode in octal notation. Defaults
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>TimeoutSec=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Configures the time to wait for the mount
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek command to finish. If a command does not exit within the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configured time, the mount will be considered failed and be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek shut down again. All commands still running will be terminated
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek forcibly via <constant>SIGTERM</constant>, and after another
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek delay of this time with <constant>SIGKILL</constant>. (See
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>.)
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Takes a unit-less value in seconds, or a time span value such
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek as "5min 20s". Pass 0 to disable the timeout logic. The
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek default value is set from the manager configuration file's
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varname>DefaultTimeoutStart=</varname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for more settings.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.device</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>proc</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
3ba3a79df4ae094d1008c04a9af8d1ff970124c4Zbigniew Jędrzejewski-Szmek <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-fstab-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>