LEIL-FILEREPAIR(1)

📦 version 5.12.0, in nixpkgs unstable

💅 LEIL-FILEREPAIR 💅

okay so bestie, welcome to the leil-filerepair manual page — this is the one from the LeilFS family (the whole gang lives in leil(1) fyi) and honestly? it's giving emergency-room energy for your files. let's get into it 🩹✨

🌸 NAME 🌸

leil-filerepair — repair broken files, no cap 💖

🦋 SYNOPSIS 🦋

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

like, you run it with leil filerepair and then hand it one or more FILEs. that's the whole vibe check. 🫶

✨ DESCRIPTION ✨

so filerepair deals with broken files — and by "broken" we literally mean those which cause I/O errors on read operations 😭 — and its whole main-character job is to make them partially readable. not fully healed, bestie, just readable enough. manage expectations 💅

here's how it handles the two scenarios:

  • missing chunk? 👑 it fills the missing parts of the file with zeros. icon that it is.
  • chunk version mismatch? 🔥 it sets the chunk version known to leil-master to the highest one found on chunkservers. slay, we love a promotion arc.
🚨 Note (put your reading glasses on for this one fr fr): because in the second case content mismatch can occur in chunks with the same version, it's advised to make a copy (not a snapshot!) and delete the original file after "repairing". yes — copy, delete, move on. the quotation marks around "repairing" are doing a LOT of work there and honestly they should 💀

🎀 OPTIONS 🎀

  • -c — enables correct-only mode 💜 which will restore the chunk to a previous version if possible, but will never erase any data. like, ever. it's a lover not a fighter, a restorer not a deleter. 🌸
  • -n, -h, -H — these bad boys are described over in leil(1), so go check the mothership for the deets 🧚 iykyk

🐛 REPORTING BUGS 🐛

found a bug? 🪲 do NOT suffer in silence bestie — report bugs to the GitHub repository https://github.com/leil-io/leilfs as an issue. bring receipts, we love that for you 💖

okay legal moment, stay with me 👑

Copyright 2008-2009 Gemius SA

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

Copyright 2023-2024 Leil Storage OÜ

LeilFS 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. 🔓

LeilFS 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. 🙈 (yes, that's the "we can't promise anything" paragraph, and it means it.)

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

💀 SEE ALSO 💀

leil(1) — go read it, it's the parent friend of this whole situation 🫶

and that's the page, babe 🎀 this little beauty comes to you from the LEIL-FILEREPAIR(1) manual, dated 1980-01-01 (yes, that date is real and it's iconically ancient ⭐) — now go fix those files, you absolute legend 👑✨

📦 where this page comes from