SFSMETARESTORE(8)

📦
version 5.8.0 · 4 versions
, in ubuntu stonking

✨ SFSMETARESTORE(8) ✨

okay so bestie, welcome to sfsmetarestore — section 8 of the manual, the big-girl sysadmin section 💅 this is the tool that replays SaunaFS metadata change logs or dumps a SaunaFS metadata image. it's giving "recovery era" and honestly? iconic. 🎀

🌸 NAME 🌸

sfsmetarestore — replay SaunaFS metadata change logs or dump SaunaFS metadata image 🦋

💖 SYNOPSIS 💖

sfsmetarestore [-z] -m OLDMETADATAFILE -o NEWMETADATAFILE [CHANGELOGFILE...]

sfsmetarestore -m METADATAFILE

sfsmetarestore [-z] -a [-d DIRECTORY]

sfsmetarestore -g -d DIRECTORY

sfsmetarestore -v

sfsmetarestore -?

six whole moods, periodt. pick one 💫

🫶 DESCRIPTION 🫶

so when you call sfsmetarestore with both -m and -o, it replays the CHANGELOGFILEs you gave it on top of OLDMETADATAFILE and writes the whole result to NEWMETADATAFILE. and yes, you can hand it multiple change log files, not just one — go off 💅

if you call sfsmetarestore with just -m METADATAFILE? it dumps the SaunaFS metadata image file in human readable form. a little peek behind the curtain, we love that for us ✨

and when you call it with -a, it automatically performs all the operations needed to merge change log files — fully hands-free, main character energy 👑 you can point it at the master data directory with the -d DIRECTORY option.

then there's sfsmetarestore -g with a path to metadata files: it prints the latest metadata version that can be restored from disk. and if the metadata files are corrupted? it prints 0. so if you see a 0, go hydrate and then go fix ur files 😭

  • -v — print version information and exit. a lil flex 📢
  • -a — autorestore mode (see above, bestie, it's the automatic merge situation)
  • -d DATAPATH — master data directory (for autorestore mode)
  • -g DIRECTORY — Print 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 🙈

🎀 FILES 🎀

  • metadata.sfs — Sauna File System metadata image as read by sfsmaster process
  • metadata.sfs.back — Sauna File System metadata image as left by killed or crashed sfsmaster process (rip to that process fr fr 💀)
  • changelog.*.sfs — Sauna File System metadata change logs

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, bestie. Report bugs to the GitHub repository https://github.com/leil-io/saunafs as an issue. the devs want to know, no cap 💜

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 👀

sfsrestoremaster(8), sfsmaster(8), sfs(7)

that's the whole page, bestie — go restore some metadata, u got this 🫶

sfsmetarestore — page dated 2026-07-29 — from the SFSMETARESTORE(8) manual 💖✨

📦 where this page comes from