mfsarchive(1)

NAME
mfsarchive - MooseFS archive storage mode management tools

SYNOPSIS
mfschkarchive [-?] [-n|-h|-H|-k|-m|-g] OBJECT...

mfsclrarchive [-?] [-n|-h|-H|-k|-m|-g] OBJECT...

mfssetarchive [-?] [-n|-h|-H|-k|-m|-g] OBJECT...

DESCRIPTION
These tools operate on a filesystem object's (file, special file, or directory) archive bit. This bit is usually set automatically according to storage class definition (ARCH_DELAY). When this bit is set then ARCH_LABELS from storage class definition are used, otherwise KEEP_LABES are used.

mfschkarchive prints current archive bit value of given object(s). If given OBJECT is a DIRECTORY then it prints current archive bit value of all contained files (recursively).

mfsclrarchive and mfssetarchive clears/sets current archive bit of given object(s). As in mfschkarchive if OBJECT is a DIRECTORY then this tool works recursively.

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.

REPORTING BUGS
Report bugs to <bugs@moosefs.com>.

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 <https://www.gnu.org/licenses/>.

SEE ALSO
mfsmount(8), mfstools(1), mfssclass(1)