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)