NAME

       mfssclass - MooseFS storage classes management tools

SYNOPSIS

       mfsgetsclass [-?] [-r] [-n|-h|-H|-k|-m|-g] OBJECT...

       mfssetsclass [-?] [-r] [-n|-h|-H|-k|-m|-g] SCLASS_NAME OBJECT...

       mfscopysclass [-?] [-r] [-n|-h|-H|-k|-m|-g] SOURCE_OBJECT OBJECT...

       mfsxchgsclass [-?] [-r] [-n|-h|-H|-k|-m|-g] SRC_SCLASS_NAME DST_SCLASS_NAME OBJECT...

DESCRIPTION

       These  tools  operate on object's storage class name. This is an extended version of classic goal.  There
       are  predefined  storage  classes  provided  as  equivalents  of  goals  1  to  9   (names   are   simply
       "1","2",...,"9").  Other  classes  can be created/modified/deleted etc. by administrator using mfsscadmin
       tool.

       mfsgetsclass prints current storage class of given object(s).  -r  option  enables  recursive  mode,  for
       files  there  is  no  difference,  for  directories  it shows the number of objects in each storage class
       containded in the whole subtree of this directory.

       mfssetsclass changes current storage class of given object(s).  -r option enables recursive mode.

       mfscopysclass copies storage class from one object to given object(s).

       mfsxchgsclass sets storage class to DST_SCLASS_NAME of given objects(s) but  only  when  current  storage
       class is set to SRC_SCLASS_NAME.

GENERAL OPTIONS

       Most  MooseFS  tools 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.

       Option -? displays short usage message.

INHERITANCE

       When a new object is created in MooseFS, storage class is inherited from the parent  directory.  A  newly
       created  object  inherits  always the current value of its parent's storage class. Changing a directory's
       storage class does not affect its already created children. To change storage class for a  directory  and
       all of its children use -r option.

REPORTING BUGS

       Report bugs to <bugs@moosefs.com>.

COPYRIGHT

       Copyright (C) 2025 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 MooseFS; if  not,  write  to
       the  Free  Software  Foundation,  Inc.,  51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA or visit
       http://www.gnu.org/licenses/gpl-2.0.html

SEE ALSO

       mfsmount(8), mfstools(1), mfsscadmin(1)

MooseFS 4.57.5-1                                  February 2025                                     mfssclass(1)