NAME

       mfsdiagtools - MooseFS diagnostic tools

SYNOPSIS

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

DESCRIPTION

       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.

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

       -i     show number of inodes

       -d     show number of directories

       -f     show number of files

       -c     show number of chunks

       -l     show length

       -s     show size

       -r     show realsize

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 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 http://www.gnu.org/licenses/gpl-2.0.html

SEE ALSO

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