mfstrashtime "1" "August 2021" "MooseFS 3.0.116-1" "This is part of MooseFS"
NAME
mfstrashtime -
MooseFS trash time (retention) management tools
SYNOPSIS
mfsgettrashtime [
-r] [
-n|
-h|
-H|
-k|
-m|
-g]
OBJECT...
mfssettrashtime [-r] [-n|-h|-H|-k|-m|-g] SECONDS[+|-] OBJECT...
mfscopytrashtime [-r] [-n|-h|-H|-k|-m|-g] SOURCE_OBJECT OBJECT...
mfsrgettrashtime [-n|-h|-H|-k|-m|-g] OBJECT...
mfsrsettrashtime [-n|-h|-H|-k|-m|-g] SECONDS[+|-] OBJECT...
DESCRIPTION
These tools operate on object's
trashtime value, i.e. the number of seconds the file is preserved in
special
trash directory before it's finally removed from filesystem.
Trashtime must be non-negative integer value.
mfsgettrashtime prints current trashtime value of given object(s).
-r option enables recursive mode, which works as usual for every given
file, but for every given directory additionally prints current trashtime
value of all contained objects (files and directories).
mfssettrashtime changes current trashtime value of given object(s).
If new value is specified in SECONDS+ form, trashtime value is
increased to SECONDS for objects with lower trashtime value and unchanged
for the rest. Similarly, if new value is specified as SECONDS-,
trashtime value is decreased to SECONDS for objects with higher
trashtime value and unchanged for the rest. -r option enables
recursive mode.
These tools can be used on any file, directory or deleted (trash) file.
mfscopytrashtime tool can be used to copy trashtime value from one object to another.
mfsrgettrashtime and mfsrsettrashtime are deprecated aliases for
mfsgettrashtime -r and mfssettrashtime -r respectively.
PRECISION
Since version 3.0 of MooseFS
trashtime is stored in the system as number of
hours
the file is preserved in
trash directory. Given value in seconds is rounded up to hours.
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)