Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
mfssclass(1)		    This is part of MooseFS		  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...

       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 us-
       ing mfsscadmin tool.

       mfsgetsclass  prints  current storage class of given object(s).	-r op-
       tion enables recursive mode, for	files there is no difference, for  di-
       rectories  it  shows  the  number of objects in each storage class con-
       tainded in the whole subtree of this directory.

       mfssetsclass changes current storage class of given object(s).  -r  op-
       tion 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 en-
       ables 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  MFSHRFOR-
       MAT  environment	 variable  to:	0 (exact numbers), 1 or	h (binary pre-
       fixes), 2 or H (SI prefixes), 3 or h+ (exact numbers  and  binary  pre-
       fixes),	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	direc-
       tory. So	if you set i.e.	"noowner" attribute and	storage	class to  "im-
       portant"	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  un-
       der  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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mfsgetsclass&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help