FreeBSD Manual Pages
mfstrashtime(1) This is part of MooseFS mfstrashtime(1) 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 inte- ger 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 trash- time 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 un- changed 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 ob- ject to another. mfsrgettrashtime and mfsrsettrashtime are deprecated aliases for mfs- gettrashtime -r and mfssettrashtime -r respectively. PRECISION Since version 3.0 of MooseFS trashtime is stored in the system as num- ber 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 MFSHRFOR- MAT environment variable to: 0 (exact numbers), 1 or h (binary pre- fixes), 2 or H (SI prefixes), 3 or h+ (exact numbers and binary pre- fixes), 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 direc- tory. So if you set i.e. "noowner" attribute and storage class to "im- portant" 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 un- der 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) MooseFS 3.0.117-1 February 2023 mfstrashtime(1)
NAME | SYNOPSIS | DESCRIPTION | PRECISION | GENERAL OPTIONS | INHERITANCE | REPORTING BUGS | COPYRIGHT | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mfssettrashtime&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>