home | help
mfstools(1)		     This is part of MooseFS		     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, mfsre-
     namesclass, 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  vari-
     able 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 stor-
     age class set to "important" and "noowner" flag set. A newly created object
     inherits  always the current set of its parent's attributes. Changing a di-
     rectory 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 Soft-
     ware 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  de-
     tails.

     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),   mf-
     squota(1),  mfssnapshots(1),  mfssclass(1), mfsfacl(1), mfsscadmin(1), mfs-
     patadmin(1), mfsmount(8)

MooseFS 4.59.1-1		    May 2026			     mfstools(1)

home | help