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 attrib-
       utes 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  en-
       tries 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 mfsmakesnap-
       shot 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  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), mfssnapshots(1)

MooseFS	3.0.117-1		 February 2023			   mfseattr(1)

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

home | help