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   SPDX-License-Identifier: LGPL-2.1+
   6
   7   This file is part of systemd.
   8
   9   Copyright 2012 Lennart Poettering
  10 -->
  11 <refentry id="systemd-fsck@.service">
  12
  13   <refentryinfo>
  14     <title>systemd-fsck@.service</title>
  15     <productname>systemd</productname>
  16
  17     <authorgroup>
  18       <author>
  19         <contrib>Developer</contrib>
  20         <firstname>Lennart</firstname>
  21         <surname>Poettering</surname>
  22         <email>lennart@poettering.net</email>
  23       </author>
  24     </authorgroup>
  25   </refentryinfo>
  26
  27   <refmeta>
  28     <refentrytitle>systemd-fsck@.service</refentrytitle>
  29     <manvolnum>8</manvolnum>
  30   </refmeta>
  31
  32   <refnamediv>
  33     <refname>systemd-fsck@.service</refname>
  34     <refname>systemd-fsck-root.service</refname>
  35     <refname>systemd-fsck</refname>
  36     <refpurpose>File system checker logic</refpurpose>
  37   </refnamediv>
  38
  39   <refsynopsisdiv>
  40     <para><filename>systemd-fsck@.service</filename></para>
  41     <para><filename>systemd-fsck-root.service</filename></para>
  42     <para><filename>/usr/lib/systemd/systemd-fsck</filename></para>
  43   </refsynopsisdiv>
  44
  45   <refsect1>
  46     <title>Description</title>
  47
  48     <para><filename>systemd-fsck@.service</filename> and
  49     <filename>systemd-fsck-root.service</filename> are services
  50     responsible for file system checks. They are instantiated for each
  51     device that is configured for file system checking.
  52     <filename>systemd-fsck-root.service</filename> is responsible for
  53     file system checks on the root file system, but only if the
  54     root filesystem was not checked in the initramfs.
  55     <filename>systemd-fsck@.service</filename> is used for all other
  56     file systems and for the root file system in the initramfs.</para>
  57
  58     <para>These services are started at boot if
  59     <option>passno</option> in <filename>/etc/fstab</filename> for the
  60     file system is set to a value greater than zero. The file system
  61     check for root is performed before the other file systems. Other
  62     file systems may be checked in parallel, except when they are on
  63     the same rotating disk.</para>
  64
  65     <para><filename>systemd-fsck</filename> does not know any details
  66     about specific filesystems, and simply executes file system
  67     checkers specific to each filesystem type
  68     (<filename>/sbin/fsck.*</filename>). This helper will decide if
  69     the filesystem should actually be checked based on the time since
  70     last check, number of mounts, unclean unmount, etc.</para>
  71
  72     <para>If a file system check fails for a service without
  73     <option>nofail</option>, emergency mode is activated, by isolating
  74     to <filename>emergency.target</filename>.</para>
  75   </refsect1>
  76
  77   <refsect1>
  78     <title>Kernel Command Line</title>
  79
  80     <para><filename>systemd-fsck</filename> understands these kernel
  81     command line parameters:</para>
  82
  83     <variablelist class='kernel-commandline-options'>
  84       <varlistentry>
  85         <term><varname>fsck.mode=</varname></term>
  86
  87         <listitem><para>One of <literal>auto</literal>,
  88         <literal>force</literal>, <literal>skip</literal>. Controls
  89         the mode of operation. The default is <literal>auto</literal>,
  90         and ensures that file system checks are done when the file
  91         system checker deems them necessary. <literal>force</literal>
  92         unconditionally results in full file system checks.
  93         <literal>skip</literal> skips any file system
  94         checks.</para></listitem>
  95       </varlistentry>
  96
  97       <varlistentry>
  98         <term><varname>fsck.repair=</varname></term>
  99
 100         <listitem><para>One of <literal>preen</literal>,
 101         <literal>yes</literal>, <literal>no</literal>. Controls the
 102         mode of operation. The default is <literal>preen</literal>,
 103         and will automatically repair problems that can be safely
 104         fixed. <literal>yes</literal> will answer yes to all
 105         questions by fsck and <literal>no</literal> will answer no to
 106         all questions. </para></listitem>
 107       </varlistentry>
 108     </variablelist>
 109   </refsect1>
 110
 111   <refsect1>
 112     <title>See Also</title>
 113     <para>
 114       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 115       <citerefentry project='man-pages'><refentrytitle>fsck</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 116       <citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 117       <citerefentry project='man-pages'><refentrytitle>fsck.btrfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 118       <citerefentry project='man-pages'><refentrytitle>fsck.cramfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 119       <citerefentry project='man-pages'><refentrytitle>fsck.ext4</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 120       <citerefentry project='man-pages'><refentrytitle>fsck.fat</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 121       <citerefentry project='man-pages'><refentrytitle>fsck.hfsplus</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 122       <citerefentry project='man-pages'><refentrytitle>fsck.minix</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 123       <citerefentry project='man-pages'><refentrytitle>fsck.ntfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 124       <citerefentry project='man-pages'><refentrytitle>fsck.xfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 125     </para>
 126   </refsect1>
 127
 128 </refentry>