]>
Commit | Line | Data |
---|---|---|
a32f224a LP |
1 | <?xml version="1.0"?> |
2 | <!--*-nxml-*--> | |
3a54a157 | 3 | <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
eea10b26 | 4 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> |
db9ecf05 | 5 | <!-- SPDX-License-Identifier: LGPL-2.1-or-later --> |
c101b656 | 6 | <refentry id="systemd-fsck_.service" xmlns:xi="http://www.w3.org/2001/XInclude"> |
a32f224a | 7 | |
798d3a52 ZJS |
8 | <refentryinfo> |
9 | <title>systemd-fsck@.service</title> | |
10 | <productname>systemd</productname> | |
798d3a52 ZJS |
11 | </refentryinfo> |
12 | ||
13 | <refmeta> | |
14 | <refentrytitle>systemd-fsck@.service</refentrytitle> | |
15 | <manvolnum>8</manvolnum> | |
16 | </refmeta> | |
17 | ||
18 | <refnamediv> | |
19 | <refname>systemd-fsck@.service</refname> | |
20 | <refname>systemd-fsck-root.service</refname> | |
5e975053 | 21 | <refname>systemd-fsck-usr.service</refname> |
798d3a52 ZJS |
22 | <refname>systemd-fsck</refname> |
23 | <refpurpose>File system checker logic</refpurpose> | |
24 | </refnamediv> | |
25 | ||
26 | <refsynopsisdiv> | |
73e97bb0 ZJS |
27 | <para><simplelist> |
28 | <member><filename>systemd-fsck@.service</filename></member> | |
29 | <member><filename>systemd-fsck-root.service</filename></member> | |
30 | <member><filename>systemd-fsck-usr.service</filename></member> | |
31 | <member><filename>/usr/lib/systemd/systemd-fsck</filename></member> | |
32 | </simplelist></para> | |
798d3a52 ZJS |
33 | </refsynopsisdiv> |
34 | ||
35 | <refsect1> | |
36 | <title>Description</title> | |
37 | ||
5e975053 YW |
38 | <para><filename>systemd-fsck@.service</filename>, <filename>systemd-fsck-root.service</filename>, and |
39 | <filename>systemd-fsck-usr.service</filename> are services responsible for file system checks. They are | |
40 | instantiated for each device that is configured for file system checking. | |
41 | <filename>systemd-fsck-root.service</filename> and <filename>systemd-fsck-usr.service</filename> are | |
42 | responsible for file system checks on the root and /usr file system, respectively, but only if the root | |
43 | filesystem was not checked in the initrd. <filename>systemd-fsck@.service</filename> is used for all | |
44 | other file systems and for the root file system in the initrd.</para> | |
798d3a52 | 45 | |
000680a6 AAF |
46 | <para>These services are started at boot if <option>passno</option> in <filename>/etc/fstab</filename> |
47 | for the file system is set to a value greater than zero, but only if it is also configured to be | |
48 | mounted at boot (i.e. without <literal>noauto</literal> option). The file system check for root is | |
49 | performed before the other file systems. Other file systems may be checked in parallel, except when | |
50 | they are on the same rotating disk.</para> | |
798d3a52 ZJS |
51 | |
52 | <para><filename>systemd-fsck</filename> does not know any details | |
53 | about specific filesystems, and simply executes file system | |
54 | checkers specific to each filesystem type | |
a108fcba | 55 | (<filename>fsck.<replaceable>type</replaceable></filename>). These checkers will decide if |
798d3a52 ZJS |
56 | the filesystem should actually be checked based on the time since |
57 | last check, number of mounts, unclean unmount, etc.</para> | |
58 | ||
5e975053 | 59 | <para><filename>systemd-fsck-root.service</filename> and <filename>systemd-fsck-usr.service</filename> |
bf63dadb ZJS |
60 | will activate <filename>reboot.target</filename> if <command>fsck</command> returns the "System |
61 | should reboot" condition, or <filename>emergency.target</filename> if <command>fsck</command> | |
4b499063 SL |
62 | returns the "Filesystem errors left uncorrected" condition.</para> |
63 | ||
64 | <para><filename>systemd-fsck@.service</filename> will fail if | |
bf63dadb | 65 | <command>fsck</command> returns with either "System should reboot" |
4b499063 SL |
66 | or "Filesystem errors left uncorrected" conditions. For filesystems |
67 | listed in <filename>/etc/fstab</filename> without <literal>nofail</literal> | |
68 | or <literal>noauto</literal> options, <literal>local-fs.target</literal> | |
69 | will then activate <filename>emergency.target</filename>.</para> | |
798d3a52 ZJS |
70 | </refsect1> |
71 | ||
72 | <refsect1> | |
73 | <title>Kernel Command Line</title> | |
74 | ||
bf63dadb | 75 | <para><command>systemd-fsck</command> understands these kernel |
2dcf2a17 | 76 | command line parameters:</para> |
798d3a52 ZJS |
77 | |
78 | <variablelist class='kernel-commandline-options'> | |
79 | <varlistentry> | |
80 | <term><varname>fsck.mode=</varname></term> | |
81 | ||
82 | <listitem><para>One of <literal>auto</literal>, | |
83 | <literal>force</literal>, <literal>skip</literal>. Controls | |
84 | the mode of operation. The default is <literal>auto</literal>, | |
85 | and ensures that file system checks are done when the file | |
86 | system checker deems them necessary. <literal>force</literal> | |
87 | unconditionally results in full file system checks. | |
88 | <literal>skip</literal> skips any file system | |
ec07c3c8 AK |
89 | checks.</para> |
90 | ||
91 | <xi:include href="version-info.xml" xpointer="v186"/></listitem> | |
798d3a52 ZJS |
92 | </varlistentry> |
93 | ||
94 | <varlistentry> | |
95 | <term><varname>fsck.repair=</varname></term> | |
96 | ||
97 | <listitem><para>One of <literal>preen</literal>, | |
98 | <literal>yes</literal>, <literal>no</literal>. Controls the | |
2dcf2a17 | 99 | mode of operation. The default is <literal>preen</literal>, |
798d3a52 | 100 | and will automatically repair problems that can be safely |
2dcf2a17 | 101 | fixed. <literal>yes</literal> will answer yes to all |
798d3a52 | 102 | questions by fsck and <literal>no</literal> will answer no to |
ec07c3c8 AK |
103 | all questions. </para> |
104 | ||
105 | <xi:include href="version-info.xml" xpointer="v213"/></listitem> | |
798d3a52 ZJS |
106 | </varlistentry> |
107 | </variablelist> | |
108 | </refsect1> | |
109 | ||
110 | <refsect1> | |
111 | <title>See Also</title> | |
13a69c12 DT |
112 | <para><simplelist type="inline"> |
113 | <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member> | |
114 | <member><citerefentry project='man-pages'><refentrytitle>fsck</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
115 | <member><citerefentry><refentrytitle>systemd-quotacheck.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
116 | <member><citerefentry project='url'><refentrytitle url='https://btrfs.readthedocs.io/en/latest/fsck.btrfs.html'>fsck.btrfs</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
117 | <member><citerefentry project='man-pages'><refentrytitle>fsck.cramfs</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
118 | <member><citerefentry project='man-pages'><refentrytitle>fsck.ext4</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
119 | <member><citerefentry project='man-pages'><refentrytitle>fsck.fat</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
120 | <member><citerefentry project='man-pages'><refentrytitle>fsck.hfsplus</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
121 | <member><citerefentry project='man-pages'><refentrytitle>fsck.minix</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
122 | <member><citerefentry project='man-pages'><refentrytitle>fsck.ntfs</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
123 | <member><citerefentry project='man-pages'><refentrytitle>fsck.xfs</refentrytitle><manvolnum>8</manvolnum></citerefentry></member> | |
124 | </simplelist></para> | |
798d3a52 | 125 | </refsect1> |
a32f224a LP |
126 | |
127 | </refentry> |