SAUNAFS-FILEREPAIR(1)

📦
version 5.8.0 · 4 versions
, in ubuntu stonking

💖 SAUNAFS-FILEREPAIR 💖

bestie. this is the saunafs-filerepair manual page — section 1, so it's a command, and it's the one you call when your files are lowkey falling apart. let's get into it 🫶

✨ NAME ✨

saunafs-filerepair — repair broken files 🩹

🌸 SYNOPSIS 🌸

saunafs filerepair [-n|-h|-H] FILE...

🦋 DESCRIPTION 🦋

okay so here's the vibe. filerepair deals with broken files — and by broken we mean the ones that straight up cause I/O errors when you try to read them. the goal? make them partially readable. not perfect, not brand new, just… readable. and honestly? that's enough sometimes 💅

here's how it does its thing, depending on what's wrong:

  • missing chunk → it fills the missing parts of the file with zeros. yeah, just zeroes. empty space where data used to be. it's giving ✨placeholder✨
  • chunk version mismatch → it sets the chunk version known to sfsmaster to the highest one found on chunkservers. highest version wins, periodt 👑
⚠️ Note ⚠️ in that second case, content mismatch can occur in chunks with the same version. so the advice is real and you should follow it: make a copy — not a snapshot! — and delete the original file after you're done "repairing" it. like, only after. don't skip steps bestie 😭

🎀 OPTIONS 🎀

  • -c — turns on correct-only mode. this one will restore the chunk to a previous version if it possibly can, but it will never erase any data. no data lost, no cap 🫶
  • -n, -h, -H — these ones are described over in saunafs(1). go peek there, i'm not gonna steal their moment 🧚

🐛 REPORTING BUGS 🐛

found a bug? plot twist? report it to the GitHub repository at https://github.com/leil-io/saunafs as an issue. the devs wanna know, fr fr 🔥

Copyright 2008-2009 Gemius SA

Copyright 2013-2019 Skytechnology sp. z o.o.

Copyright 2023-2024 Leil Storage OÜ

SaunaFS is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3.

SaunaFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with SaunaFS. If not, see http://www.gnu.org/licenses/.

🌈 SEE ALSO 🌈

and that's the whole page bestie 💖 this one's from the SaunaFS fam, dated 2026-07-29, and it lives in section 1 as SAUNAFS-FILEREPAIR(1). go fix those files, you absolute icon 🌟

📦 where this page comes from