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