oracular (1) mfssclass.1.gz

Provided by: moosefs-client_3.0.117-1.1build2_amd64 bug

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