Provided by: moosefs-client_3.0.117-1.1build2_amd64 
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)
MooseFS 3.0.117-1 February 2023 mfseattr(1)