SYSTEMD-FSCKD.SERVICE(8)

✨ SYSTEMD-FSCKD.SERVICE(8) ✨

okay bestie, welcome to systemd-fsckd.service — the manual page, section 8, and yes we're doing this together 💖

---

🌸 NAME 🌸

systemd-fsckd.service, systemd-fsckd.socket, systemd-fsckd — File system check progress reporting. that's the whole vibe. it reports progress on fsck. iconic behavior honestly 🎀

---

🦋 SYNOPSIS 🦋

systemd-fsckd.service

systemd-fsckd.socket

/usr/lib/systemd/systemd-fsckd

---

💅 DESCRIPTION 💅

so systemd-fsckd.service is a service, and its whole job is receiving file system check progress, then communicating some consolidated data to console and plymouth (only if plymouth is actually running, no cap). it also handles possible check cancellations. multitasking queen 👑

systemd-fsckd receives messages about file system check progress from fsck through an UNIX domain socket. it can display the progress of the least advanced fsck as well as the total number of devices being checked in parallel to the console. it will also send progress messages to plymouth. and get this — both the raw data and translated messages are sent, so compiled plymouth themes can use the raw data to display custom messages, and scripted themes (which don't support i18n) can display the translated versions. everybody eats 🍓

systemd-fsckd will instruct plymouth to grab Control+C keypresses. when the key is pressed, running checks will be terminated. it will also cancel any newly connected fsck instances for the lifetime of systemd-fsckd. like… it holds a grudge, but make it graceful 💀

---

🌈 PROTOCOL FOR COMMUNICATION WITH PLYMOUTH 🌈

systemd-fsckd passes the following messages to the theme:

Progress update, sent as a plymouth update message:

"fsckd:<num_devices>:<progress>:<string>"

• <num_devices> — the current number of devices being checked (int). literally just a count, bestie.
• <progress> — the current minimum percentage of all devices being checking (float, from 0 to 100). yes it says "being checking", we're keeping it, character for character, don't come for me 🙈
• <string> — a translated message ready to be displayed by the plymouth theme displaying the data above. it can be overridden by themes supporting i18n.

Cancel message, sent as a traditional plymouth message:

"fsckd-cancel-msg:<string>"

• <strings> — a translated string ready to be displayed by the plymouth theme indicating that Control+C can be used to cancel current checks. it can be overridden (matching only "fsckd-cancel-msg" prefix) by themes supporting i18n. so yes, the prefix match is the whole gatekeep, and that's on purpose ✨

---

🎀 OPTIONS 🎀

the following options are understood:

• -h, --help — print a short help text and exit. cute, quick, no notes.
• --version — print a short version string and exit. also quick. also iconic.

---

👑 EXIT STATUS 👑

on success, 0 is returned, a non-zero failure code otherwise. note that the daemon stays idle for a while to accept new fsck connections before exiting — it's not ghosting you, it's just lingering a lil bit 🫶

---

🔥 SEE ALSO 🔥

systemd(1), systemd-fsck(8), 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)

---

and that's the whole page, bestie 💖 this was brought to you by systemd 255, SYSTEMD-FSCKD.SERVICE(8), go touch some grass now 🌸🧚⭐