--- name: "mfstrashretention" section: "1" platform: "linux" package: "moosefs" version: "4.59.2-2" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/mfstrashretention" --- # mfstrashretention(1) MooseFS trash retention management tools ## NAME mfstrashretention - **MooseFS** trash retention management tools ## SYNOPSIS **mfsgettrashretention** \[**-?**\] \[**-r**\] \[**-n**\|**-h**\|**-H**\|**-k**\|**-m**\|**-g**\] *OBJECT*... **mfssettrashretention** \[**-?**\] \[**-r**\] \[**-n**\|**-h**\|**-H**\|**-k**\|**-m**\|**-g**\] *TIME*\[**+**\|**-**\] *OBJECT*... **mfscopytrashretention** \[**-?**\] \[**-r**\] \[**-n**\|**-h**\|**-H**\|**-k**\|**-m**\|**-g**\] *SOURCE\_OBJECT* *OBJECT*... ## DESCRIPTION These tools operate on a filesystem object's (file, special file, or directory) *trash retention* value, i.e. the time the file is preserved in special *trash* directory before it's finally removed from filesystem. *Trash retention* must be a non-negative integer value. **mfsgettrashretention** prints current *trash retention* 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 *trash retention* value of all contained objects (files and directories). **mfssettrashretention** changes current *trash retention* value of given object(s). If new value is specified in *TIME***+** form, *trash retention* value is increased to *TIME* for objects with lower *trash retention* value and unchanged for the rest. Similarly, if new value is specified as *TIME***-**, *trash retention* value is decreased to *TIME* for objects with higher *trash retention* value and unchanged for the rest. **-r** option enables recursive mode. These tools can be used on any file, directory or deleted (*trash*) file. **mfscopytrashretention** tool can be used to copy *trash retention* value from one object to another. *TIME* parameter is specified as a general time type value, with minimum unit being hours and with an additional possibility of adding a + or - sign at the end; for details about time format see TIME ## 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 ### TIME For time variables their value can be defined as a number of seconds or hours (integer), depending on minimum unit of the variable, or as a time period in one of two possible formats: first format: #.#T where T is one of: s-seconds, m-minutes, h-hours, d-days or w-weeks; fractions of minimum unit will be rounded to integer value second format: #w#d#h#m#s, any number of definitions can be omitted, but the remaining definitions must be in order (so #d#m is still a valid definition, but #m#d is not); ranges: s,m: 0 to 59, h: 0 to 23, d: 0 t o 6, w is unlimited and the first definition is also always unlimited (i.e. for #d#h#m d will be unlimited) If a minimum unit of a variable is larger than seconds, units below the minimum one will not be accepted. For example, a variable that has hours as a minimum unit will not accept s and m units. Examples: 1\.5d is the same as 1d12h, is the same as 36h 2\.5w is the same as 2w3d12h, is the same as 420h; 2w84h is not a valid time period (h is not the first definition, so it is bound by range 0 to 23) ### INHERITANCE When a new object is created in MooseFS, trash retention is inherited from the parent directory. A newly created object inherits always the current value of its parent's trash retention. Changing a directory's trash retention does not affect its already created children. To change trash retention 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), [**mfstools**(1)](/mfstools/1.md)