Scroll to navigation

mfsdiagtools(1) This is part of MooseFS mfsdiagtools(1)


mfsdiagtools - MooseFS diagnostic tools


mfscheckfile FILE...

mfsfilerepair [-n|-h|-H|-k|-m|-g] FILE...

mfsfileinfo FILE...

mfsdirinfo [-n|-h|-H|-k|-m|-g] [-i|-d|-f|-c|-l|-s|-r] [-p] OBJECT...

mfsfilepaths OBJECT|INODE...


mfscheckfile checks and prints number of chunks and number of chunk copies belonging to specified file(s). It can be used on any file, included deleted (trash).

mfsfilerepair deals with broken files (those which cause I/O errors on read operations) to make them partially readable. In case of missing chunk it fills missing parts of file with zeros; in case of chunk version mismatch it sets chunk version known to mfsmaster to highest one found on chunkservers. Note: because in the second case content mismatch can occur in chunks with the same version, it is advised to make a copy (not a snapshot!) and delete original file after "repairing".

mfsfileinfo prints location (chunkserver host and port) of each chunk copy belonging to specified file(s). It can be used on any file, included deleted (trash).

mfsdirinfo is extended, MooseFS-specific equivalent of du -s command. It prints summary for each specified object (single file or directory tree). If you only want to see one parameter, then add one of show options (see SHOW OPTIONS). By default it returns data from internal master counters (very fast, but not precise). All repeated nodes (hard links) and chunks (snapshots) are counted multiple times. To count stats more preciselly you can use -p switch which turns on slow, recursive procedure. In this mode nodes and chunks are counted only once and the system uses current number of chunk copies instead of goal/labels. System administrators might consider using mfsmetadirinfo (see mfsmetadirinfo(8)).

mfsfilepaths tool can be used to find all occurrences (hard links) of given file in filesystem. It can also be used to find a file with given i-node number. In case of searching for i-node number, the tool has to be run in mfs mounted directory.


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


show number of inodes
show number of directories
show number of files
show number of chunks
show length
show size
show realsize


Report bugs to <>.


Copyright (C) 2021 Jakub Kruszona-Zawadzki, Core Technology Sp. z o.o.

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 MooseFS; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA or visit


mfsmount(8), mfstools(1), mfsmetadirinfo(8)

August 2021 MooseFS 3.0.116-1