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