chiark / gitweb /
man: document systemd-remount-fs.service
[elogind.git] / man / systemd-remount-fs.service.xml
1 <?xml version="1.0"?>
2 <!--*-nxml-*-->
3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4 <!--
5   This file is part of systemd.
6
7   Copyright 2012 Lennart Poettering
8
9   systemd is free software; you can redistribute it and/or modify it
10   under the terms of the GNU Lesser General Public License as published by
11   the Free Software Foundation; either version 2.1 of the License, or
12   (at your option) any later version.
13
14   systemd is distributed in the hope that it will be useful, but
15   WITHOUT ANY WARRANTY; without even the implied warranty of
16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17   Lesser General Public License for more details.
18
19   You should have received a copy of the GNU Lesser General Public License
20   along with systemd; If not, see <http://www.gnu.org/licenses/>.
21 -->
22 <refentry id="systemd-remount-fs.service">
23
24         <refentryinfo>
25                 <title>systemd-remount-fs.service</title>
26                 <productname>systemd</productname>
27
28                 <authorgroup>
29                         <author>
30                                 <contrib>Developer</contrib>
31                                 <firstname>Lennart</firstname>
32                                 <surname>Poettering</surname>
33                                 <email>lennart@poettering.net</email>
34                         </author>
35                 </authorgroup>
36         </refentryinfo>
37
38         <refmeta>
39                 <refentrytitle>systemd-remount-fs.service</refentrytitle>
40                 <manvolnum>8</manvolnum>
41         </refmeta>
42
43         <refnamediv>
44                 <refname>systemd-remount-fs.service</refname>
45                 <refname>systemd-remount-fs</refname>
46                 <refpurpose>Remount Root and Kernel File Systems</refpurpose>
47         </refnamediv>
48
49         <refsynopsisdiv>
50                 <para><filename>systemd-remount-fs.service</filename></para>
51                 <para><filename>/usr/lib/systemd/systemd-remount-fs</filename></para>
52         </refsynopsisdiv>
53
54         <refsect1>
55                 <title>Description</title>
56
57                 <para><filename>systemd-remount-fs.service</filename>
58                 is an early-boot service that applies mount options
59                 listed in
60                 <citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>
61                 to the root file system and the kernel API virtual
62                 file systems. This is required so that the mount
63                 options of these file systems -- which are pre-mounted
64                 by the kernel, the initial RAM disk or system manager
65                 code -- are updated to those listed in
66                 <filename>/etc/fstab</filename>. This service ignores
67                 normal file systems and only changes the root file
68                 system (i.e. <filename>/</filename>) and the virtual
69                 kernel API file systems such as
70                 <filename>/proc</filename>, <filename>/sys</filename>
71                 or <filename>/dev/</filename>. This service executes
72                 no operation if <filename>/etc/fstab</filename> does
73                 not exist or lists no entries for the root file system
74                 or the kernel API VFS.</para>
75         </refsect1>
76
77         <refsect1>
78                 <title>See Also</title>
79                 <para>
80                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
81                         <citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
82                         <citerefentry><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
83                 </para>
84         </refsect1>
85
86 </refentry>