3 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5 SPDX-License-Identifier: LGPL-2.1+
7 <refentry id=
"systemd-remount-fs.service">
10 <title>systemd-remount-fs.service
</title>
11 <productname>systemd
</productname>
15 <refentrytitle>systemd-remount-fs.service
</refentrytitle>
16 <manvolnum>8</manvolnum>
20 <refname>systemd-remount-fs.service
</refname>
21 <refname>systemd-remount-fs
</refname>
22 <refpurpose>Remount root and kernel file systems
</refpurpose>
26 <para><filename>systemd-remount-fs.service
</filename></para>
27 <para><filename>/usr/lib/systemd/systemd-remount-fs
</filename></para>
31 <title>Description
</title>
33 <para><filename>systemd-remount-fs.service
</filename> is an early boot service that applies mount options
34 listed in
<citerefentry
35 project='man-pages'
><refentrytitle>fstab
</refentrytitle><manvolnum>5</manvolnum></citerefentry>, or
36 gathered from the partition table (when
37 <citerefentry><refentrytitle>systemd-gpt-auto-generator
</refentrytitle><manvolnum>8</manvolnum></citerefentry>
38 is active) to the root file system, the
<filename>/usr
</filename> file system, and the kernel API file
39 systems. This is required so that the mount options of these file systems — which are pre-mounted by the
40 kernel, the initial RAM disk, container environments or system manager code — are updated to those
41 configured in
<filename>/etc/fstab
</filename> and the other sources. This service ignores normal file
42 systems and only changes the root file system (i.e.
<filename>/
</filename>),
<filename>/usr
</filename>,
43 and the virtual kernel API file systems such as
<filename>/proc
</filename>,
<filename>/sys
</filename> or
44 <filename>/dev
</filename>. This service executes no operation if no configuration is found
45 (
<filename>/etc/fstab
</filename> does not exist or lists no entries for the mentioned file systems, or
46 the partition table does not contain relevant entries).
</para>
48 <para>For a longer discussion of kernel API file systems see
49 <ulink url=
"https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems">API
50 File Systems
</ulink>.
</para>
52 <para>Note:
<filename>systemd-remount-fs.service
</filename> is usually pulled in by
53 <citerefentry><refentrytitle>systemd-fstab-generator
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
54 hence it is also affected by the kernel command line option
<varname>fstab=
</varname>, which may be used
55 to disable the generator. It may also pulled in by
56 <citerefentry><refentrytitle>systemd-gpt-auto-generator
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
57 which is affected by
<varname>systemd.gpt_auto
</varname> and other options.
</para>
61 <title>See Also
</title>
63 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
64 <citerefentry project='man-pages'
><refentrytitle>fstab
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
65 <citerefentry project='man-pages'
><refentrytitle>mount
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
66 <citerefentry><refentrytitle>systemd-fstab-generator
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
67 <citerefentry><refentrytitle>systemd-gpt-auto-generator
</refentrytitle><manvolnum>8</manvolnum></citerefentry>