NAME

       mfseattr - MooseFS extra attributes management tools

SYNOPSIS

       mfsgeteattr [-r] [-n|-h|-H|-k|-m|-g] OBJECT...

       mfsseteattr [-r] [-n|-h|-H|-k|-m|-g] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

       mfsdeleattr [-r] [-n|-h|-H|-k|-m|-g] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

       mfscopyeattr [-r] [-n|-h|-H|-k|-m|-g] SOURCE_OBJECT OBJECT...

DESCRIPTION

       These tools are used to get, set or delete some extra attributes (flags).

       Attributes:

       noowner This flag means, that particular object belongs to current user (uid and gid are equal to uid and
       gid values of accessing process). Only root (uid=0) sees the real uid and gid.

       noattrcache This flag means, that standard file attributes such as uid, gid, mode, length and so on won't
       be  stored  in  kernel  cache.  In MooseFS 1.5 this was the only behaviour, and mfsmount always prevented
       attributes from being stored in kernel cache, but in MooseFS 1.6 attributes can be  cached,  so  in  very
       rare occasions it could be useful to turn it off.

       noentrycache This flag is similar to above. It prevents directory entries from being cached in kernel.

       nodatacache This flag means, that data cache should be cleared every time a file is opened.

       snapshot This flag means that the object was created via a mfsmakesnapshot command

       undeletable This flag prevents unlinking (admin only; not inherited)

       appendonly  Object  with  this  flag  can  only be appended to, unlinking and other modifications are not
       allowed (admin only; not inherited)

       immutable This flag prevents any change to given object (admin only; not inherited)

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) 2021 Jakub Kruszona-Zawadzki, Core Technology Sp. z o.o.

       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), mfssnapshots(1)