FSCK.ZFS(8)

📦
version 2.4.4 · 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 FSCK.ZFS(8) 💖

okay bestie, this is a page from the System Manager's Manual, and it's about fsck.zfs — the dummy ZFS filesystem checker. yes, dummy. she's not doing much and she knows it. let's get into it 🫶

✨ NAME ✨

fsck.zfs — dummy ZFS filesystem checker

like, that's the whole job description. dummy. iconic of her honestly 💅

🌸 SYNOPSIS 🌸

fsck.zfs [options] dataset…

that's it, that's the vibe. you pass her some *dataset*s, she looks at them, she moves on 🦋

💜 DESCRIPTION 💜

so fsck.zfs is a thin shell wrapper, and at most it checks the status of a dataset's container pool. that's the ceiling. that's the whole dream.

why does it even exist?? because OpenZFS installs it — some Linux distributions just expect a fsck helper for every filesystem that exists, so we gave them one. she's here to fill a slot, and she's serving regardless 😭✨

oh and if you specify more than one dataset? each one gets checked in turn, and then the results get binary-ored together. math girlie behavior fr fr 🧮

🎀 OPTIONS 🎀

  • options — Ignored.

yes bestie, literally ignored. she heard you, she said "okay!" and did nothing with it. no cap. 🙈

👑 NOTES 👑

okay here's the actual tea. ZFS datasets get checked by running zpool scrub on the containing pool. so an individual ZFS dataset is never checked independently of its pool — which is unlike a regular filesystem. the dataset does not get its own solo moment. she's part of a group project, periodt. 💀

however, the fsck(8) interface still lets her communicate some errors:

  • if the dataset is in a degraded pool, then fsck.zfs will return exit code 4 to indicate an uncorrected filesystem error. 🚨
  • similarly, if the dataset is in a faulted pool and has a legacy /etc/fstab record, then fsck.zfs will return exit code 8 to indicate a fatal operational error. 💀
so like, she's quiet but she's not silent. if something's wrong she WILL let the group chat know with a number. iykyk.

🌈 SEE ALSO 🌈

go read those if you want the full lore bestie 🍓

mwah — this page is brought to you by OpenZFS, dated May 26, 2021. that's the source, that's the version, that's the whole footer. slay, bye 💖✨🦋

📦 where this page comes from