mfsmetadirinfo(8)

📦
version 4.59.2 · 5 versions
, in arch rolling, nixos 26.05, nixpkgs unstable, ubuntu stonking

✨ mfsmetadirinfo ✨ — the MooseFS meta-directory-info girlie

okay so bestie, welcome to mfsmetadirinfo, one of the little tools that ships with MooseFS 💖 it's giving "detective mode" for your filesystem — no cap.

🌸 NAME 🌸

mfsmetadirinfo — uses MooseFS metadata to calculate precise directory information (similar to mfsdirinfo). literally the receipts version of mfsdirinfo, fr fr 🧾✨

🦋 SYNOPSIS 🦋

mfsmetadirinfo [-f J|C|C x] [-o outputfile] [-a sum_name] metadata_file
PATH [PATH...]

💅 DESCRIPTION 💅

so mfsmetadirinfo is a tool that can be used to calculate precise directory information — things like number of inodes, number of chunks, total length of all files, size, real size, etc. 🎀

and the output?? she's flexible. plain text, CSV, or JSON, pick your vibe. the data for all those calculations gets read from the indicated metadata.mfs mfs master metadata file, and it's calculated for the directory(ies) you specify with the PATH parameter(s) — relative in mfs instance, just so we're clear 🫶

default output is human-readable plain text, and JSON or CSV can be selected using options. iconic honestly.

✨ Options ✨

  • -f — switch output format to JSON (J) or CSV (C); for CSV, if only C is specified, default separator will be used (comma), if second character is specified, this character will be used as the separator in CSV data 💫
  • -o — write output to outputfile instead of stdout
  • -a — optional parameter that indicates the tool should calculate the information for all supplied paths together (a sum), this calculation is indicated by sum_name in output data
  • metadata_file — path to metadata.mfs file 📁

🎀 OUTPUT FIELDS 🎀

for each PATH and, if defined, for sum_name, following information will be indicated:

  • inodes — number of all unique inodes (file system objects)
  • files — number of all unique files
  • dirs — number of all unique directories
  • chunks — number of all unique chunks
  • kchunks — number of all unique chunks using KEEP policy
  • achunks — number of all unique chunks using ARCH policy
  • length — total length of all unique files
  • size — total size of all unique chunks
  • rsize — total real size of all unique chunks (number of copies taken into account)
  • ksize — hypothetical real size of all unique chunks if all were using KEEP policy
  • asize — hypothetical real size of all unique chunks if all were using ARCH policy

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence bestie, report bugs to <bugs@moosefs.com>. 🐛

Copyright (C) 2026 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 this program; if not, see <https://www.gnu.org/licenses/>.

🌈 SEE ALSO 🌈

MooseFS 4.59.2-1 🌟 May 2026 — k bye bestie, go count some inodes, you ate 💅✨🫶

📦 where this page comes from