Skip to main content

mfstools

Perform MooseFS-specific operations.

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

TRASH RETENTION MANAGEMENT TOOLS​

mfsgettrashretention, mfssettrashretention, mfscopytrashretention

EXTRA ATTRIBUTES MANAGEMENT TOOLS​

mfsgeteattr, mfsseteattr, mfsdeleattr, mfscopyeattr

ARCHIVE BIT MANIPULATION TOOLS​

mfschkarchive, mfssetarchive, mfsclrarchive

DIAGNOSTIC TOOLS​

mfscheckfile, mfsfileinfo, mfsdirinfo, mfsfilepaths, mfsfilerepair

QUOTA MANAGEMENT TOOLS​

mfsgetquota, mfssetquota, mfsdelquota, mfscopyquota

SNAPSHOT TOOLS​

mfsappendchunks, mfsmakesnapshot, mfsrmsnapshot

STORAGE CLASSES MANAGEMENT TOOLS​

mfsgetsclass, mfssetsclass, mfscopysclass, mfsxchgsclass

ACL MANAGEMENT TOOLS​

mfsgetfacl, mfssetfacl

STORAGE CLASSES ADMINISTRATION TOOLS​

mfscreatesclass, mfsmodifysclass, mfsdeletesclass, mfsclonesclass, mfsrenamesclass, mfslistsclass, mfsimportsclass

PATTERNS ADMINISTRATION TOOLS​

mfscreatepattern, mfsdeletepattern, mfslistpattern \# MFS_PRO_MARKER_START

PATCH TOOLS​

mfscreatepatch, mfsapplypatch, mfsdumppatch

LOCATION TOOLS​

mfslocationcreate mfslocationdelete mfslocationsetdefault mfslocationstate mfslocationunmap mfslocationmap mfslocationlist \# MFS_PRO_MARKER_END

Notes​

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

INHERITANCE​

When new object is created in MooseFS, attributes such as storage class, trash retention and extra attributes are inherited from parent directory. So if you set i.e. "noowner" attribute and storage class to "important" 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. Exception: special objects, for which trash retention and storage class is not relevant due to their nature (FIFO, symlink, block device, socket) have the trashretention value and storage class set to a constant instead.

PATTERNS​

Since version 4.2.0 above attributes (storage class, trash retention and extra attributes) can be overridden by defining specific name patterns.

See also​

mfstrashretention(1), mfseattr(1), mfsarchive(1), mfsdiagtools(1), mfsquota(1), mfssnapshots(1), mfssclass(1), mfsfacl(1), mfsscadmin(1), mfspatadmin(1), \# MFS_PRO_MARKER_START mfspatch(1), mfslocadmin(1), \# MFS_PRO_MARKER_END mfsmount(8)