LEIL-METARESTORE(8)

💖 NAME 💖

okay bestie, meet leil-metarestore — that's LEIL-METARESTORE(8) if you're being all formal 💅. It's here to replay LeilFS metadata change logs or dump a LeilFS metadata image. iconic little metadata gremlin behavior, honestly 🦋.

✨ SYNOPSIS ✨

leil-metarestore [-z] -m OLDMETADATAFILE -o NEWMETADATAFILE [CHANGELOGFILE...]

leil-metarestore -m METADATAFILE

leil-metarestore [-z] -a [-d DIRECTORY]

leil-metarestore -g -d DIRECTORY

leil-metarestore -v

leil-metarestore -?

🌸 DESCRIPTION 🌸

When leil-metarestore gets both -m and -o, it replays the CHANGELOGFILEs you give it on OLDMETADATAFILE and writes the result to NEWMETADATAFILE. Multiple change log files can be given — yes bestie, bring the whole group chat 😭.

With just -m METADATAFILE, it dumps the LeilFS metadata image file in human readable form. It's giving "let me read the metadata tea for you" ☕✨.

When you call it with -a, it automatically performs all operations needed to merge change log files. The master data directory can be specified with the -d DIRECTORY option.

leil-metarestore -g with a path to metadata files prints the latest metadata version that can be restored from disk. Prints 0 if metadata files are corrupted. That's the vibe check, no cap 💀.

Then the options, bestie — every single one, no skipping:

• -v — print version information and exit. cute little info drop, then it's out 💨
• -a — autorestore mode (see above). the full auto-glow-up ✨
• -d DATAPATH — master data directory (for autorestore mode)
• -g DIRECTORY — prints the latest metadata version that can be restored from disk at the directory. Prints 0 if metadata files are corrupted 🫶
• -m METADATAFILE — specify input metadata image file
• -o NEWMETADATAFILE — specify output metadata image file
• -z — ignore metadata checksum inconsistency while applying changelogs. literally what it says 💅

🎀 FILES 🎀

• metadata.sfs — Leil File System metadata image as read by leil-master process
• metadata.sfs.back — Leil File System metadata image as left by killed or crashed leil-master process
• changelog.*.sfs — Leil File System metadata change logs

🐛 REPORTING BUGS 🐛

found a bug? no cap, report it to the GitHub repository at https://github.com/leil-io/leilfs as an issue. the maintainers will appreciate the receipts 🔥.

👑 COPYRIGHT 👑

the legal receipts, bestie:

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

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 🌈

go peek at leil-restoremaster(8), leil-master(8), and leilfs(7) — the whole friend group 🫶.

---

xoxo, your LEIL-METARESTORE(8) bestie 💅 — dated 1980-01-01. periodt 🎀