mfstools(1)

📦
version 4.59.2 · 5 versions
, in arch rolling, nixos 26.05, nixpkgs unstable, ubuntu stonking

✨ NAME ✨

mfstools — the whole MooseFS bestie toolkit 💖 it does all the MooseFS-specific operations, and honestly? it's a whole squad, not just one command. So let me introduce you to everyone in the group chat, block by block 👑

🗑️ TRASH RETENTION MANAGEMENT TOOLS

mfsgettrashretention, mfssettrashretention, mfscopytrashretention

🎀 EXTRA ATTRIBUTES MANAGEMENT TOOLS

mfsgeteattr, mfsseteattr, mfsdeleattr, mfscopyeattr

📦 ARCHIVE BIT MANIPULATION TOOLS

mfschkarchive, mfssetarchive, mfsclrarchive

🩺 DIAGNOSTIC TOOLS

mfscheckfile, mfsfileinfo, mfsdirinfo, mfsfilepaths, mfsfilerepair

📊 QUOTA MANAGEMENT TOOLS

mfsgetquota, mfssetquota, mfsdelquota, mfscopyquota

📸 SNAPSHOT TOOLS

mfsappendchunks, mfsmakesnapshot, mfsrmsnapshot

💅 STORAGE CLASSES MANAGEMENT TOOLS

mfsgetsclass, mfssetsclass, mfscopysclass, mfsxchgsclass

🔐 ACL MANAGEMENT TOOLS

mfsgetfacl, mfssetfacl

👑 STORAGE CLASSES ADMINISTRATION TOOLS

mfscreatesclass, mfsmodifysclass, mfsdeletesclass, mfsclonesclass, mfsrenamesclass, mfslistsclass, mfsimportsclass

🧚 PATTERNS ADMINISTRATION TOOLS

mfscreatepattern, mfsdeletepattern, mfslistpattern

📓 NOTES 📓

🔢 GENERAL OPTIONS

okay so most of mfstools share the same little number-glow-up squad: -n, -h, -H, -k, -m and -g. These are all about how your numbers get printed, and bestie there are options:

  • -n — prints exact numbers, no shortcuts, no vibes, just the raw truth 💯
  • -h — uses binary prefixes: Ki, Mi, Gi, which are 2^10, 2^20, etc.
  • -H — uses SI prefixes: k, M, G, which are 10^3, 10^6, etc.
  • -k — shows plain numbers in kibis (that's binary kilo, 1024)
  • -m — shows plain numbers in mebis (binary mega, 1024^2)
  • -g — shows plain numbers in gibis (binary giga, 1024^3)

✨ plot twist ✨ you can get all the same behaviour by setting the MFSHRFORMAT environment variable, and here's the mapping because it is giving secret menu:

  • 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, if you don't say anything? Just exact numbers. periodt.

🧬 INHERITANCE

When a new object gets created in MooseFS, its attributes — storage class, trash retention, extra attributes — are inherited from the parent directory. It's giving strong family resemblance, honestly.

So like, if you set the "noowner" attribute and set storage class to "important" in a directory, then every new object created in that directory will have storage class set to "important" and the "noowner" flag set. A newly created object always inherits the current set of its parent's attributes. 🫶

⚠️ but listen: changing a directory attribute does not affect its already-created children. The past is the past, bestie. If you want to change an attribute for a directory and all of its children, use the -r option.

🎯 PATTERNS

Since version 4.2.0 and above, those attributes we just talked about (storage class, trash retention and extra attributes) can be overridden by defining specific name patterns. iconique behaviour fr fr 🌈

🐛 REPORTING BUGS 🐛

Found a bug? Not the cute kind? 😭 Report bugs to <bugs@moosefs.com>.

Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA

This file is part of MooseFS.

MooseFS 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 2 (only).

MooseFS 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 this program; if not, see <https://www.gnu.org/licenses/>.

👀 SEE ALSO 👀

mfstrashretention(1), mfseattr(1), mfsarchive(1), mfsdiagtools(1), mfsquota(1), mfssnapshots(1), mfssclass(1), mfsfacl(1), mfsscadmin(1), mfspatadmin(1), mfsmount(8)

and that's the whole page, bestie 💜 this one's from MooseFS 4.59.2-1, dated May 2026, and yeah — it's part of MooseFS in case the "This is part of MooseFS" at the top didn't already give it away 😌 go forth and slay your filesystem 👑🦋

📦 where this page comes from