|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | KERNEL COMMAND LINE | CREDENTIALS | SEE ALSO | COLOPHON |
|
|
|
SYSTEMD-FSCK@.SERVICE(8) systemd-fsck@.service SYSTEMD-FSCK@.SERVICE(8)
systemd-fsck@.service, systemd-fsck-root.service, systemd-fsck-
usr.service, systemd-fsck - File system checker logic
systemd-fsck@.service
systemd-fsck-root.service
systemd-fsck-usr.service
/usr/lib/systemd/systemd-fsck
systemd-fsck@.service, systemd-fsck-root.service, and
systemd-fsck-usr.service are services responsible for file system
checks. They are instantiated for each device that is configured
for file system checking. systemd-fsck-root.service and
systemd-fsck-usr.service are responsible for file system checks on
the root and /usr file system, respectively, but only if the root
filesystem was not checked in the initrd. systemd-fsck@.service
is used for all other file systems and for the root file system in
the initrd.
These services are started at boot if passno in /etc/fstab for the
file system is set to a value greater than zero, but only if it is
also configured to be mounted at boot (i.e. without "noauto"
option). The file system check for root is performed before the
other file systems. Other file systems may be checked in parallel,
except when they are on the same rotating disk.
systemd-fsck does not know any details about specific filesystems,
and simply executes file system checkers specific to each
filesystem type (fsck.type). These checkers will decide if the
filesystem should actually be checked based on the time since last
check, number of mounts, unclean unmount, etc.
systemd-fsck-root.service and systemd-fsck-usr.service will
activate reboot.target if fsck(8) returns the "System should
reboot" condition, or emergency.target if fsck returns the
"Filesystem errors left uncorrected" condition.
systemd-fsck@.service will fail if fsck(8) returns either the
"System should reboot" or the "Filesystem errors left uncorrected"
condition. For filesystems listed in /etc/fstab without "nofail"
or "noauto" options, local-fs.target will then activate
emergency.target.
systemd-fsck understands these kernel command line parameters:
fsck.mode=
One of "auto", "force", "skip". Controls the mode of
operation. The default is "auto", and ensures that file system
checks are done when the file system checker deems them
necessary. "force" unconditionally results in full file
system checks. "skip" skips any file system checks.
Added in version 186.
fsck.repair=
One of "preen", "yes", "no". Controls the mode of operation.
The default is "preen", and will automatically repair problems
that can be safely fixed. "yes" will answer yes to all
questions by fsck and "no" will answer no to all questions.
Added in version 213.
systemd-fsck supports the service credentials logic as implemented
by ImportCredential=/LoadCredential=/SetCredential= (see
systemd.exec(5) for details). The following credentials are used
when passed in:
fsck.mode, fsck.repair
The contents of the credentials are parsed as same as the
kernel command line options with the same name. See above for
more details.
Added in version 258.
Note that by default the systemd-fsck@.service,
systemd-fsck-root.service, and systemd-fsck-usr.service unit files
are set up to inherit both fsck.mode and fsck.repair credentials
from the service manager.
systemd(1), fsck(8), systemd-quotacheck@.service(8),
fsck.btrfs(8), fsck.cramfs(8), fsck.ext4(8), fsck.fat(8),
fsck.hfsplus(8), fsck.minix(8), fsck.ntfs(8), fsck.xfs(8)
This page is part of the systemd (systemd system and service
manager) project. Information about the project can be found at
⟨http://www.freedesktop.org/wiki/Software/systemd⟩. If you have a
bug report for this manual page, see
⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
This page was obtained from the project's upstream Git repository
⟨https://github.com/systemd/systemd.git⟩ on 2025-08-11. (At that
time, the date of the most recent commit that was found in the
repository was 2025-08-11.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
systemd 258~rc2 SYSTEMD-FSCK@.SERVICE(8)
Pages that refer to this page: kernel-command-line(7), systemd.directives(7), systemd.index(7), systemd.system-credentials(7), systemd-quotacheck@.service(8)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|