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