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) 2023 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), mfstools(1)