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...

       mfslistsclass [-l] [MOUNT_POINT]

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.

       mfslistsclass lists currently defined storage classes.  -l option enables  long  format  -
       whole  class  definition  is printed for each class, not only its name. For description of
       storage class definition refer to mfsscadmin manpage.

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, trashtime 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.

REPORTING BUGS

       Report bugs to <bugs@moosefs.com>.

COPYRIGHT

       Copyright (C) 2023 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)