LIZARDFS-FILEREPAIR(1)

📦 version 3.12.0, in fedora 43

✨ LIZARDFS-FILEREPAIR ✨

okay bestie, so this one is lizardfs-filerepair — like, the section-1 manual page for the filerepair command, and it's literally here to fix your broken files. 🩹✨

💖 NAME 💖

lizardfs-filerepair — repair broken files. that's it, that's the whole vibe. 🛠️

🎀 SYNOPSIS 🎀

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

yes bestie, it's a lizardfs subcommand, not a standalone binary, iykyk. 💅

🦋 DESCRIPTION 🦋

so filerepair deals with broken files — and by broken we mean the ones that throw I/O errors on read operations — and its whole goal is to make them partially readable. not fully, not magically, just partially. manage your expectations, queen. 👑

here's the tea on what it actually does:

  • if a chunk is missing, it fills the missing parts of the file with zeros. so yeah, you get a file back, but those parts are just… zeroes. 🫥
  • if there's a chunk version mismatch, it sets the chunk version known to mfsmaster to the highest one found on the chunkservers</b>. slay, i guess. 🔥
⚠️ IMPORTANT NOTE, DO NOT SKIP THIS ONE: because in that second case a content mismatch can occur in chunks that have the same version, it is advised that you make a copy (not a snapshot! like, fr fr, NOT a snapshot) and then delete the original file after "repairing" it. yes, "repairing" is in scare quotes. the manpage said it, not me. 😭

💅 OPTIONS 💅

  • -c — this one turns on correct-only mode, which will restore the chunk to a previous version if it possibly can, but will never erase any data. safety first, bestie. 🛡️✨
  • -n, -h, -H — these are all described over in lizardfs(1). go read that one, it's giving reference energy. 📖

Copyright 2008-2009 Gemius SA, 2013-2016 Skytechnology sp. z o.o.

LizardFS 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.

LizardFS 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 LizardFS. If not, see http://www.gnu.org/licenses/. 📜

🌈 SEE ALSO 🌈

  • lizardfs(1) — the main character of the LizardFS manpage cinematic universe. go say hi. 🫶

LizardFS File Repair Manual · page rendered 07/24/2025 · and that's the whole page bestie, you ate this, now go fix those chunks 💖✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜

📦 where this page comes from