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)

MooseFS 3.0.117-1                                 February 2023                                     mfssclass(1)