Skip to main content

mfsarchive

MooseFS archive storage mode management tools.

This page reproduces the manual page mfsarchive(1) as the product ships it: the text man mfsarchive 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​

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. When this bit is set then ARCHIVE state definitions from storage class are used, otherwise KEEP definitions are used for objects in the filesystem. Behaviour for deleted objects (TRASH state) may vary. For details about storage classes and modes see mfsscadmin(1).

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 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.

See also​

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