FreeBSD Manual Pages
mfsdiagtools(1) This is part of MooseFS mfsdiagtools(1) 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, 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- metadirinfo(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 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. 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 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 http://www.gnu.org/licenses/gpl-2.0.html SEE ALSO mfsmount(8), mfstools(1), mfsmetadirinfo(8) MooseFS 3.0.117-1 February 2023 mfsdiagtools(1)
NAME | SYNOPSIS | DESCRIPTION | GENERAL OPTIONS | SHOW OPTIONS | REPORTING BUGS | COPYRIGHT | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mfsfilepaths&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>