NAME

       mfstrashtime - DEPRECATED MooseFS trash time management tools (use mfstrashretention tools instead)

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...

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.

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  MooseFS  tools 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.

       Option -? displays short usage message.

INHERITANCE

       When a new object is created in MooseFS, trashtime is  inherited  from  the  parent  directory.  A  newly
       created  object  inherits  always  the  current  value  of its parent's trashtime. Changing a directory's
       trashtime does not affect its already created children. To change trashtime for a directory  and  all  of
       its children use -r option.

REPORTING BUGS

       Report bugs to <bugs@moosefs.com>.

COPYRIGHT

       Copyright (C) 2025 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), mfstrashretention(1), mfstools(1)

MooseFS 4.57.5-1                                  February 2025                                  mfstrashtime(1)