LIZARDFS(1)

📦 version 3.12.0, in fedora 43

🦎✨ NAME ✨🦎

okay so bestie, this is the manual page for lizardfs — and yes, it's the LIZARDFS(1) one, section 1, we're here, we're thriving 💅 — and what it does is open up a prompt for you to perform LizardFS-specific operations. That's the whole vibe. Periodt.

🌈 SYNOPSIS 🌈

no cap, here's the whole menu of moves you can pull, verbatim, don't @ me:

lizardfs getgoal [-r] [-n|-h|-H] OBJECT...

lizardfs rgetgoal [-n|-h|-H] OBJECT...

lizardfs setgoal [-r] [-n|-h|-H] NAME OBJECT...

lizardfs rsetgoal [-n|-h|-H] [+|-]N OBJECT...

lizardfs setquota (-u UID | -g GID) SOFT-LIMIT-SIZE HARD-LIMIT-SIZE
              SOFT-LIMIT-INODES HARD-LIMIT-INODES MOUNTPOINT-ROOT-PATH

lizardfs repquota [-nhH] (-u UID | -g GID)+ MOUNTPOINT-ROOT-PATH
lizardfs repquota [-nhH] -a MOUNTPOINT-ROOT-PATH

lizardfs gettrashtime [-r] [-n|-h|-H] OBJECT...

lizardfs rgettrashtime [-n|-h|-H] OBJECT...

lizardfs settrashtime [-r] [-n|-h|-H] [+|-]SECONDS OBJECT...

lizardfs rsettrashtime [-n|-h|-H] [+|-]SECONDS OBJECT...

lizardfs geteattr [-r] [-n|-h|-H] OBJECT...

lizardfs seteattr [-r] [-n|-h|-H] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

lizardfs deleattr [-r] [-n|-h|-H] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

lizardfs checkfile FILE...

lizardfs fileinfo FILE...

lizardfs dirinfo [-n|-h|-H] OBJECT...

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

lizardfs appendchunks SNAPSHOT_FILE OBJECT...

lizardfs makesnapshot [-o] SOURCE... DESTINATION

lizardfs rremove [-l] OBJECT...

💖 DESCRIPTION 💖

See respective documents. 🦋

Like — genuinely, that's what it says. Each one of those lil subcommands up there has its own whole doc, its own lore, its own moment. Go read them, iykyk.

✨ GENERAL OPTIONS ✨

🎀 number formatting, the group-chat classic 🎀

Most of the lizardfs operations use these options to pick how printed numbers get formatted. Choose your fighter:

  • -n — print the exact numbers, like 1024. Raw. Unfiltered. Iconic.
  • -h — print numbers with binary prefixes (Ki, Mi, Gi as 2^10, 2^20 etc.). Math girlie behavior, we love her.
  • -H — print numbers with SI prefixes (k, M, G as 10^3, 10^6 etc.). Metric supremacy, honestly.

🌸 the environment variable of it all 🌸

You can get the exact same result by setting the MFSHRFORMAT environment variable to one of these:

  • 0 — exact numbers
  • 1 or h — binary prefixes
  • 2 or H — SI prefixes
  • 3 or h+ — exact numbers and binary prefixes
  • 4 or H+ — exact numbers and SI prefixes
The default is to print just exact numbers. No drama, no prefixes, just the numbers fr fr.

🫶 other options 🫶

  • -r — this option enables recursive mode. It goes down the whole tree. She's thorough. She's committed. She's giving main character energy.

🦋 INHERITANCE 🦋

So here's the tea ☕ when a new object gets created in LizardFS, its attributes — stuff like goal, trashtime and extra attributes — get inherited from the parent directory. Baby object, parent's whole personality, immediately.

So if you set, i.e., the "noowner" attribute and goal to 3 in a directory, then every new object created in that directory will have goal set to 3 and the "noowner" flag set. A newly created object always inherits the current set of its parent's attributes. 💫

But — and this is the important part — changing a directory attribute does not affect its already created children. The existing kids are not getting a makeover. They're grown. They've moved out. 😭

So if you want to change an attribute for a directory and all of its children, use the -r option. That's the whole point of her. Go off, -r. 👑

💀 REPORTING BUGS 💀

Found a bug? Not me finding a bug 🙈 — report bugs to <contact@lizardfs.org>. Tell them everything, they can handle it.

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

LizardFS is free software, and like any self-respecting free software icon, 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. Slay. 💅

LizardFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY — not even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Read the GNU General Public License for more details, bestie, it's all in there.

You should have received a copy of the GNU General Public License along with LizardFS. If not, see http://www.gnu.org/licenses/. Go get your copy, you deserve licensing clarity. 🎀

🌟 SEE ALSO 🌟

the whole friend group, all linked up, all iconic:

mfsmount(1), lizardfs-appendchunks(1), lizardfs-checkfile(1), lizardfs-deleattr(1), lizardfs-dirinfo(1), lizardfs-fileinfo(1), lizardfs-filerepair(1), lizardfs-geteattr(1), lizardfs-getgoal(1), lizardfs-gettrashtime(1), lizardfs-makesnapshot(1), lizardfs-rgetgoal(1), lizardfs-rgettrashtime(1), lizardfs-rsetgoal(1), lizardfs-rsettrashtime(1), lizardfs-seteattr(1), lizardfs-setgoal(1), lizardfs-settrashtime(1), lizardfs-rremove(1), lizardfs-repquota(1), lizardfs-setquota(1), moosefs(7)

and that's the whole page, bestie 🫶 this version of LIZARDFS(1) is dated 07/24/2025 — that's the LIZARDFS(1) footer energy right there, saving you the scroll to the bottom 💖 k bye, go format some numbers ✨

📦 where this page comes from