diff options
Diffstat (limited to 'man/systemd.mount.html')
-rw-r--r-- | man/systemd.mount.html | 47 |
1 files changed, 34 insertions, 13 deletions
diff --git a/man/systemd.mount.html b/man/systemd.mount.html index 348755a154..35b0b53540 100644 --- a/man/systemd.mount.html +++ b/man/systemd.mount.html @@ -19,7 +19,7 @@ <a href="systemd.directives.html">Directives </a>· <a href="../python-systemd/index.html">Python </a>· <a href="../libudev/index.html">libudev </a>· - <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 219</span><hr><div class="refentry"><a name="systemd.mount"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd.mount — Mount unit configuration</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename"><em class="replaceable"><code>mount</code></em>.mount</code></p></div><div class="refsect1"><a name="idm139734078522512"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>A unit configuration file whose name ends in + <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 220</span><hr><div class="refentry"><a name="systemd.mount"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd.mount — Mount unit configuration</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename"><em class="replaceable"><code>mount</code></em>.mount</code></p></div><div class="refsect1"><a name="idm139904516575104"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>A unit configuration file whose name ends in "<code class="literal">.mount</code>" encodes information about a file system mount point controlled and supervised by systemd.</p><p>This man page lists the configuration options specific to this unit type. See @@ -30,7 +30,7 @@ configured in the [Mount] section.</p><p>Additional options are listed in <a href="systemd.exec.html"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>, which define the execution environment the - <a href="mount.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> + <a href="http://man7.org/linux/man-pages/man8/mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> binary is executed in, and in <a href="systemd.kill.html"><span class="citerefentry"><span class="refentrytitle">systemd.kill</span>(5)</span></a>, which define the way the processes are terminated, and in @@ -40,7 +40,7 @@ particularly useful for mount units specifying a "<code class="literal">Type=</code>" option or using configuration not specified in <code class="filename">/etc/fstab</code>; - <a href="mount.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> + <a href="http://man7.org/linux/man-pages/man8/mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> will refuse options that are not listed in <code class="filename">/etc/fstab</code> if it is not run as UID 0.</p><p>Mount units must be named after the mount point directories they control. Example: the mount point @@ -58,12 +58,12 @@ <code class="filename">/proc/self/mountinfo</code> description in <a href="http://man7.org/linux/man-pages/man5/proc.5.html"><span class="citerefentry"><span class="refentrytitle">proc</span>(5)</span></a>. </p><p>Some file systems have special semantics as API file systems - for kernel-to-userspace and userspace-to-userpace interfaces. Some + for kernel-to-userspace and userspace-to-userspace interfaces. Some of them may not be changed via mount units, and cannot be disabled. For a longer discussion see <a class="ulink" href="http://www.freedesktop.org/wiki/Software/systemd/APIFileSystems" target="_top">API - File Systems</a>.</p></div><div class="refsect1"><a name="idm139734082402144"></a><h2 id="fstab"><code class="filename">fstab</code><a class="headerlink" title="Permalink to this headline" href="#fstab">¶</a></h2><p>Mount units may either be configured via unit files, or via + File Systems</a>.</p></div><div class="refsect1"><a name="idm139904511653712"></a><h2 id="fstab"><code class="filename">fstab</code><a class="headerlink" title="Permalink to this headline" href="#fstab">¶</a></h2><p>Mount units may either be configured via unit files, or via <code class="filename">/etc/fstab</code> (see - <a href="fstab.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a> + <a href="http://man7.org/linux/man-pages/man5/fstab.5.html"><span class="citerefentry"><span class="refentrytitle">fstab</span>(5)</span></a> for details). Mounts listed in <code class="filename">/etc/fstab</code> will be converted into native units dynamically at boot and when the configuration of the system manager is reloaded. In general, @@ -77,9 +77,30 @@ <code class="option">Requires</code> (see option <code class="option">nofail</code> below), from either <code class="filename">local-fs.target</code> or <code class="filename">remote-fs.target</code>, depending whether the file - system is local or remote.</p><div class="variablelist"><dl class="variablelist"><dt id="x-systemd.automount"><span class="term"><code class="option">x-systemd.automount</code></span><a class="headerlink" title="Permalink to this term" href="#x-systemd.automount">¶</a></dt><dd><p>An automount unit will be created for the file + system is local or remote.</p><div class="variablelist"><dl class="variablelist"><dt id="x-systemd.requires="><span class="term"><code class="option">x-systemd.requires=</code></span><a class="headerlink" title="Permalink to this term" href="#x-systemd.requires=">¶</a></dt><dd><p>Configures a <code class="varname">Requires=</code> and + an <code class="varname">After=</code> dependency between the created + mount unit and another systemd unit, such as a device or mount + unit. The argument should be a unit name, or an absolute path + to a device node or mount point. This option may be specified + more than once. This option is particularly useful for mount + point declarations that need an additional device to be around + (such as an external journal device for journal file systems) + or an additional mount to be in place (such as an overlay file + system that merges multiple mount points). See + <code class="varname">After=</code> and <code class="varname">Requires=</code> in + <a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a> + for details.</p></dd><dt id="x-systemd.requires-mounts-for="><span class="term"><code class="option">x-systemd.requires-mounts-for=</code></span><a class="headerlink" title="Permalink to this term" href="#x-systemd.requires-mounts-for=">¶</a></dt><dd><p>Configures a + <code class="varname">RequiresMountsFor=</code> dependency between the + created mount unit and other mount units. The argument must be + an absolute path. This option may be specified more than once. + See <code class="varname">RequiresMountsFor=</code> in + <a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a> + for details.</p></dd><dt id="x-systemd.automount"><span class="term"><code class="option">x-systemd.automount</code></span><a class="headerlink" title="Permalink to this term" href="#x-systemd.automount">¶</a></dt><dd><p>An automount unit will be created for the file system. See <a href="systemd.automount.html"><span class="citerefentry"><span class="refentrytitle">systemd.automount</span>(5)</span></a> + for details.</p></dd><dt id="x-systemd.idle-timeout="><span class="term"><code class="option">x-systemd.idle-timeout=</code></span><a class="headerlink" title="Permalink to this term" href="#x-systemd.idle-timeout=">¶</a></dt><dd><p>Configures the idleness timeout of the + automount unit. See <code class="varname">TimeoutIdleSec=</code> in + <a href="systemd.automount.html"><span class="citerefentry"><span class="refentrytitle">systemd.automount</span>(5)</span></a> for details.</p></dd><dt id="x-systemd.device-timeout="><span class="term"><code class="option">x-systemd.device-timeout=</code></span><a class="headerlink" title="Permalink to this term" href="#x-systemd.device-timeout=">¶</a></dt><dd><p>Configure how long systemd should wait for a device to show up before giving up on an entry from <code class="filename">/etc/fstab</code>. Specify a time in seconds or @@ -111,7 +132,7 @@ precedence over traditional configuration files, but this is superseded by the rule that configuration in <code class="filename">/etc</code> will always take precedence over - configuration in <code class="filename">/usr</code>.</p></div><div class="refsect1"><a name="idm139734082359936"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>Mount files must include a [Mount] section, which carries + configuration in <code class="filename">/usr</code>.</p></div><div class="refsect1"><a name="idm139904511611248"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>Mount files must include a [Mount] section, which carries information about the file system mount points it supervises. A number of options that may be used in this section are shared with other unit types. These options are documented in @@ -121,7 +142,7 @@ The options specific to the [Mount] section of mount units are the following:</p><div class="variablelist"><dl class="variablelist"><dt id="What="><span class="term"><code class="varname">What=</code></span><a class="headerlink" title="Permalink to this term" href="#What=">¶</a></dt><dd><p>Takes an absolute path of a device node, file or other resource to mount. See - <a href="mount.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> + <a href="http://man7.org/linux/man-pages/man8/mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> for details. If this refers to a device node, a dependency on the respective device unit is automatically created. (See <a href="systemd.device.html"><span class="citerefentry"><span class="refentrytitle">systemd.device</span>(5)</span></a> @@ -131,14 +152,14 @@ mounting, it is created. This string must be reflected in the unit filename. (See above.) This option is mandatory.</p></dd><dt id="Type="><span class="term"><code class="varname">Type=</code></span><a class="headerlink" title="Permalink to this term" href="#Type=">¶</a></dt><dd><p>Takes a string for the file system type. See - <a href="mount.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> + <a href="http://man7.org/linux/man-pages/man8/mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a> for details. This setting is optional.</p></dd><dt id="Options="><span class="term"><code class="varname">Options=</code></span><a class="headerlink" title="Permalink to this term" href="#Options=">¶</a></dt><dd><p>Mount options to use when mounting. This takes a comma-separated list of options. This setting is optional.</p></dd><dt id="SloppyOptions="><span class="term"><code class="varname">SloppyOptions=</code></span><a class="headerlink" title="Permalink to this term" href="#SloppyOptions=">¶</a></dt><dd><p>Takes a boolean argument. If true, parsing of the options specified in <code class="varname">Options=</code> is relaxed, and unknown mount options are tolerated. This corresponds with - <a href="mount.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a>'s + <a href="http://man7.org/linux/man-pages/man8/mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a>'s <em class="parameter"><code>-s</code></em> switch. Defaults to off.</p></dd><dt id="DirectoryMode="><span class="term"><code class="varname">DirectoryMode=</code></span><a class="headerlink" title="Permalink to this term" href="#DirectoryMode=">¶</a></dt><dd><p>Directories of mount points (and any parent directories) are automatically created if needed. This option @@ -160,7 +181,7 @@ <a href="systemd.exec.html"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a> and <a href="systemd.kill.html"><span class="citerefentry"><span class="refentrytitle">systemd.kill</span>(5)</span></a> - for more settings.</p></div><div class="refsect1"><a name="idm139734077426000"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p> + for more settings.</p></div><div class="refsect1"><a name="idm139904511586912"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p> <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>, <a href="systemctl.html"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>, <a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>, @@ -170,7 +191,7 @@ <a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>, <a href="systemd.device.html"><span class="citerefentry"><span class="refentrytitle">systemd.device</span>(5)</span></a>, <a href="http://man7.org/linux/man-pages/man5/proc.5.html"><span class="citerefentry"><span class="refentrytitle">proc</span>(5)</span></a>, - <a href="mount.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a>, + <a href="http://man7.org/linux/man-pages/man8/mount.8.html"><span class="citerefentry"><span class="refentrytitle">mount</span>(8)</span></a>, <a href="systemd-fstab-generator.html"><span class="citerefentry"><span class="refentrytitle">systemd-fstab-generator</span>(8)</span></a>, <a href="systemd.directives.html"><span class="citerefentry"><span class="refentrytitle">systemd.directives</span>(7)</span></a> </p></div></div></body></html> |