man/systemd-fsck@.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-fsck@.service">
  23
  24         <refentryinfo>
  25                 <title>systemd-fsck@.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-fsck@.service</refentrytitle>
  40                 <manvolnum>8</manvolnum>
  41         </refmeta>
  42
  43         <refnamediv>
  44                 <refname>systemd-fsck@.service</refname>
  45                 <refname>systemd-fsck-root.service</refname>
  46                 <refname>systemd-fsck</refname>
  47                 <refpurpose>File system checker logic</refpurpose>
  48         </refnamediv>
  49
  50         <refsynopsisdiv>
  51                 <para><filename>systemd-fsck@.service</filename></para>
  52                 <para><filename>systemd-fsck-root.service</filename></para>
  53                 <para><filename>/usr/lib/systemd/systemd-fsck</filename></para>
  54         </refsynopsisdiv>
  55
  56         <refsect1>
  57                 <title>Description</title>
  58
  59                 <para><filename>systemd-fsck@.service</filename> and
  60                 <filename>systemd-fsck-root.service</filename> are
  61                 services responsible for file system checks. They are
  62                 instantiated for each device that is configured for
  63                 file system checking.
  64                 <filename>systemd-fsck-root.service</filename> is
  65                 responsible for file system checks on the root file
  66                 system, but in only if the root filesystem wasn't
  67                 checked in the initramfs.
  68                 <filename>systemd-fsck@.service</filename> is used for
  69                 all other file systems and for the root file system in
  70                 the initramfs.</para>
  71
  72                 <para>Those services are started at boot if
  73                 <option>passno</option> in
  74                 <filename>/etc/fstab</filename> for the file system is
  75                 set to a value greater than zero. The file system
  76                 check for root is performed before the other file
  77                 systems. Other file systems may be checked in
  78                 parallel, except when they are one the same rotating
  79                 disk.</para>
  80
  81                 <para><filename>systemd-fsck</filename> does not know
  82                 any details about specific filesystems, and simply
  83                 executes file system checkers specific to each
  84                 filesystem type (<filename>/sbin/fsck.*</filename>).
  85                 This helper will decide if the filesystem should
  86                 actually be checked based on the time since last
  87                 check, number of mounts, unclean unmount, etc.</para>
  88
  89                 <para><filename>systemd-fsck</filename> will forward
  90                 file system checking progress to the console. If a
  91                 file system check fails for a service without
  92                 <option>nofail</option>, emergency mode is activated,
  93                 by isolating to
  94                 <filename>emergency.target</filename>.</para>
  95         </refsect1>
  96
  97         <refsect1>
  98                 <title>Kernel Command Line</title>
  99
 100                 <para><filename>systemd-fsck</filename> understands
 101                 one kernel command line parameter:</para>
 102
 103                 <variablelist class='kernel-commandline-options'>
 104                         <varlistentry>
 105                                 <term><varname>fsck.mode=</varname></term>
 106
 107                                 <listitem><para>One of
 108                                 <literal>auto</literal>,
 109                                 <literal>force</literal>,
 110                                 <literal>skip</literal>. Controls the
 111                                 mode of operation. The default is
 112                                 <literal>auto</literal>, and ensures
 113                                 that file system checks are done when
 114                                 the file system checker deems them
 115                                 necessary. <literal>force</literal>
 116                                 unconditionally results in full file
 117                                 system checks. <literal>skip</literal>
 118                                 skips any file system
 119                                 checks.</para></listitem>
 120                         </varlistentry>
 121
 122                         <varlistentry>
 123                                 <term><varname>fsck.repair=</varname></term>
 124
 125                                 <listitem><para>One of
 126                                 <literal>preen</literal>,
 127                                 <literal>yes</literal>,
 128                                 <literal>no</literal>. Controls the
 129                                 mode of operation. The default is <literal>
 130                                 preen</literal>, and will automatically repair
 131                                 problems that can be safely fixed. <literal>yes
 132                                 </literal> will answer yes to all questions by
 133                                 fsck and <literal>no</literal> will answer no to
 134                                 all questions.
 135                                 </para></listitem>
 136                         </varlistentry>
 137                 </variablelist>
 138         </refsect1>
 139
 140         <refsect1>
 141                 <title>See Also</title>
 142                 <para>
 143                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 144                         <citerefentry><refentrytitle>fsck</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 145                         <citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 146                         <citerefentry><refentrytitle>fsck.btrfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 147                         <citerefentry><refentrytitle>fsck.cramfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 148                         <citerefentry><refentrytitle>fsck.ext4</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 149                         <citerefentry><refentrytitle>fsck.fat</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 150                         <citerefentry><refentrytitle>fsck.hfsplus</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 151                         <citerefentry><refentrytitle>fsck.minix</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 152                         <citerefentry><refentrytitle>fsck.ntfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 153                         <citerefentry><refentrytitle>fsck.xfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 154                 </para>
 155         </refsect1>
 156
 157 </refentry>