mfstools(1)

NAME
mfstools - perform MooseFS-specific operations

  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
Most of mfstools use -n, -h, -H, -k, -m and -g options to select format of printed numbers. -n causes to print exact numbers, -h uses binary prefixes (Ki, Mi, Gi as 2^10, 2^20 etc.) while -H uses SI prefixes (k, M, G as 10^3, 10^6 etc.). -k, -m and -g show plain numbers respectivaly in kibis (binary kilo - 1024), mebis (binary mega - 1024^2) and gibis (binary giga - 1024^3). The same can be achieved by setting MFSHRFORMAT environment variable to: 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.

  INHERITANCE
When new object is created in MooseFS, attributes such as storage class, trash retention and extra attributes are inherited from parent directory. So if you set i.e. "noowner" attribute and storage class to "important" in a directory then every new object created in this directory will have storage class set to "important" and "noowner" flag set. A newly created object inherits always the current set of its parent's attributes. Changing a directory attribute does not affect its already created children. To change an attribute for a directory and all of its children use -r option.

  PATTERNS
Since version 4.2.0 above attributes (storage class, trash retention and extra attributes) can be overridden by defining specific name patterns.

REPORTING BUGS
Report bugs to <bugs@moosefs.com>.

COPYRIGHT
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)