--- name: "mfstrashtime" section: "1" platform: "linux" package: "moosefs" version: "4.59.2-2" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/mfstrashtime" --- # mfstrashtime(1) DEPRECATED MooseFS trash time management tools (use mfstrashretention tools instead) ## 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 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 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. ## 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. ## REPORTING BUGS Report bugs to \. ## COPYRIGHT Copyright (C) 2026 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 this program; if not, see \. ## SEE ALSO [**mfsmount**(8)](/mfsmount/8.md), [**mfstrashretention**(1)](/mfstrashretention/1.md), [**mfstools**(1)](/mfstools/1.md)