apfsck(8)

📦
version 0.2.1 · 5 versions
, in arch rolling, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

✨ apfsck — check an APFS filesystem ✨

okay so bestie, welcome to the apfsck(8) page 💖 it lives in section 8 of the System Manager's Manual, and it's about to do a full vibe check on your APFS filesystem.

🌸 SYNOPSIS 🌸

apfsck [-cuvw] [-F tier2] device

🦋 DESCRIPTION 🦋

ngl, unless you're literally an APFS developer, you are probably not the target audience here. This tool is only intended for testing, periodt. And it could potentially be dangerous if you run it on a maliciously crafted filesystem. So like… be careful, okay? 😭

apfsck is an experimental tool that checks an APFS filesystem for corruption. When it finds an issue, it reports it — but it does not attempt any repair. Not even a little. For that whole fixing situation you should use the official tools provided by Apple. 👑

💅 OPTIONS 💅

  • -c — Report if the filesystem shows signs of a recent crash. 🫠
  • -u — Report the presence of unknown/unsupported features.
  • -v — Print the version number of apfsck and exit. slay, short and sweet ✨
  • -w — Report unexplained inconsistencies that may or may not be corruption. it's giving "we don't know but we're saying it anyway" 🙈
  • -F tier2 — Specify the tier 2 device for a fusion drive. 🔥

🌈 EXIT STATUS 🌈

The exit status is 0 if there was nothing to report, and 1 otherwise.

🎀 REPORTING BUGS 🎀

Please report bugs via email or, if preferred, file a github issue at https://github.com/eafer/apfsprogs/issues. bestie, they want to hear from you, fr fr 🫶

👑 AUTHOR 👑

Written by Ernesto A. Fernández <ernesto.mnd.fernandez@gmail.com>.

⭐ SEE ALSO ⭐

and that's the whole page, no cap 💜 this was apfsprogs version 0.2.1, dated June 2025 — tysm for reading, mwah 🎀✨

📦 where this page comes from