mfstrashtime
DEPRECATED MooseFS trash time management tools (use mfstrashretention tools instead).
This page reproduces the manual page mfstrashtime(1) as the product ships it: the text man mfstrashtime prints on a machine where the packages are installed. It is not edited here, and where it disagrees with the rest of this documentation, the documentation is the side kept against the sources. What the subject is: Command line 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...
Description
These tools operate on a filesystem object's (file, special file, or directory) 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.
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 respectively 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.
Notes
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. Exception: special objects, for which trash time is not relevant due to their nature (FIFO, symlink, block device, socket) have the trashtime value set to a constant instead.