chiark / gitweb /
man: bring machinectl man page up-to-date
[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, the <filename>/usr</filename>
62                 file system and the kernel API file systems. This is
63                 required so that the mount options of these file
64                 systems -- which are pre-mounted by the kernel, the
65                 initial RAM disk, container environments or system
66                 manager code -- are updated to those listed in
67                 <filename>/etc/fstab</filename>. This service ignores
68                 normal file systems and only changes the root file
69                 system (i.e. <filename>/</filename>),
70                 <filename>/usr</filename> and the virtual kernel API
71                 file systems such as <filename>/proc</filename>,
72                 <filename>/sys</filename> or
73                 <filename>/dev</filename>. This service executes no
74                 operation if <filename>/etc/fstab</filename> does not
75                 exist or lists no entries for the mentioned file
76                 systems.</para>
77
78                 <para>For a longer discussion of kernel API file
79                 systems see <ulink
80                 url="http://www.freedesktop.org/wiki/Software/systemd/APIFileSystems">API
81                 File Systems</ulink>.</para>
82         </refsect1>
83
84         <refsect1>
85                 <title>See Also</title>
86                 <para>
87                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
88                         <citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
89                         <citerefentry><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
90                 </para>
91         </refsect1>
92
93 </refentry>