Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
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, in-
       cluded 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 ver-
       sion mismatch it	sets chunk version known to mfsmaster to  highest  one
       found  on  chunkservers.	 Note: because in the second case content mis-
       match 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,  in-
       cluded 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 op-
       tions (see SHOW OPTIONS). By default it returns data from internal mas-
       ter  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,	recur-
       sive 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  mfs-

       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 MFSHRFOR-
       MAT environment variable	to: 0 (exact numbers), 1  or  h	 (binary  pre-
       fixes),	2  or  H (SI prefixes),	3 or h+	(exact numbers and binary pre-
       fixes), 4 or H+ (exact numbers and SI  prefixes).  The  default	is  to
       print just exact	numbers.

       -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

       Report bugs to <>.

       Copyright (C) 2020 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 un-
       der 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)

MooseFS	3.0.115-1		 October 2020		       mfsdiagtools(1)


Want to link to this manual page? Use this URL:

home | help