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   SPDX-License-Identifier: LGPL-2.1+
   6
   7   Copyright 2012 Lennart Poettering
   8 -->
   9 <refentry id="systemd-remount-fs.service">
  10
  11   <refentryinfo>
  12     <title>systemd-remount-fs.service</title>
  13     <productname>systemd</productname>
  14
  15     <authorgroup>
  16       <author>
  17         <contrib>Developer</contrib>
  18         <firstname>Lennart</firstname>
  19         <surname>Poettering</surname>
  20         <email>lennart@poettering.net</email>
  21       </author>
  22     </authorgroup>
  23   </refentryinfo>
  24
  25   <refmeta>
  26     <refentrytitle>systemd-remount-fs.service</refentrytitle>
  27     <manvolnum>8</manvolnum>
  28   </refmeta>
  29
  30   <refnamediv>
  31     <refname>systemd-remount-fs.service</refname>
  32     <refname>systemd-remount-fs</refname>
  33     <refpurpose>Remount root and kernel file systems</refpurpose>
  34   </refnamediv>
  35
  36   <refsynopsisdiv>
  37     <para><filename>systemd-remount-fs.service</filename></para>
  38     <para><filename>/usr/lib/systemd/systemd-remount-fs</filename></para>
  39   </refsynopsisdiv>
  40
  41   <refsect1>
  42     <title>Description</title>
  43
  44     <para><filename>systemd-remount-fs.service</filename> is an
  45     early boot service that applies mount options listed in
  46     <citerefentry project='man-pages'><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>
  47     to the root file system, the <filename>/usr</filename> file system,
  48     and the kernel API file systems. This is required so that the
  49     mount options of these file systems — which are pre-mounted by
  50     the kernel, the initial RAM disk, container environments or system
  51     manager code — are updated to those listed in
  52     <filename>/etc/fstab</filename>. This service ignores normal file
  53     systems and only changes the root file system (i.e.
  54     <filename>/</filename>), <filename>/usr</filename> and the virtual
  55     kernel API file systems such as <filename>/proc</filename>,
  56     <filename>/sys</filename> or <filename>/dev</filename>. This
  57     service executes no operation if <filename>/etc/fstab</filename>
  58     does not exist or lists no entries for the mentioned file
  59     systems.</para>
  60
  61     <para>For a longer discussion of kernel API file systems see
  62     <ulink url="https://www.freedesktop.org/wiki/Software/systemd/APIFileSystems">API
  63     File Systems</ulink>.</para>
  64   </refsect1>
  65
  66   <refsect1>
  67     <title>See Also</title>
  68     <para>
  69       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  70       <citerefentry project='man-pages'><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
  71       <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  72     </para>
  73   </refsect1>
  74
  75 </refentry>