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

FreeBSD Manual Pages

  
 
  

home | help
mfseattr(1)		     This is part of MooseFS		     mfseattr(1)

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 ...] OB-
     JECT...

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

     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 vari-
     able 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 di-
     rectory then every new object created in this directory will  have  storage
     class set to "important" and "noowner" flag set. A newly created object in-
     herits always the current set of its parent's attributes. Changing a direc-
     tory  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) 2024 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 Soft-
     ware 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  de-
     tails.

     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.118-1		   August 2024			     mfseattr(1)

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

home | help