mfssclass(1)

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)