MOGFILEDEBUG(1)

📦
version 2.30 · 2 versions
, in fedora 43

✨ MOGFILEDEBUG 💅

okay bestie, pull up a chair, because this is the mogfiledebug manual page and she is serving information 🎀

🦋 NAME 🦋

mogfiledebug — literally dumps gobs and gobs of info about a FID. that's it. that's the job. 💖

🌸 SYNOPSIS 🌸

$ mogfiledebug --trackers=host --domain=foo --key=bar
$ mogfiledebug --trackers=host --fid=1234

💜 DESCRIPTION 💜

so this is the little utility you reach for when you've got a problematic file in a mogilefs cluster and you need to know everything about it. it's also lowkey perfect for verification, or for testing out a brand new setup before you commit to it. main character energy fr fr 👑

it finds as much information about a file as it possibly can. all of the paths, any queues it might be sitting in, etc. like, the whole lore. then it will test all of the paths, MD5 hash their contents, and check the file lengths. yes, it's thorough, we love that for her 💅

so if you're seeing errors about a FID in mogilefsd's logs? plug it through mogfiledebug and it should illuminate most of the potential issues. it's giving detective. 🔍

this is also genuinely useful info to post to the mailing list, along with the error you had. share the journey bestie 🫶

🎀 OPTIONS 🎀

  • --trackers=host1:7001,host2:7001 — use these MogileFS trackers to negotiate with. give her the whole list, comma-separated, no gatekeeping.
  • --domain=<domain> — set the MogileFS domain you wanna use. 🏠
  • --key="<key>" — the key to inspect. and ngl, it can be literally any arbitrary string, no judgement.
  • --fid=<fid> — a numeric fid to inspect. provide this as an alternative to a domain/key combo. pick a lane, either one works ✨
  • --paths=[print|stat|fetch] — whether to print, stat, or fetch each path. the default is to fetch (and checksum) the contents of all paths. so heads up, by default she's actually grabbing the bytes and hashing them 💀

👑 AUTHOR 👑

Dormando <dormando@rydia.net> — iconic, we stan 🫶

💀 BUGS 💀

none known. periodt. although — could use more helpful prints, or a longer troubleshooting manual. so, you know, room to grow 🌱

🌈 LICENSE 🌈

Licensed for use and redistribution under the same terms as Perl itself. slay, legally speaking 💖

and that's the whole page, bestie!! this was perl v5.42.0, dated 2025-07-25, and it's MOGFILEDEBUG(1) — go debug something and text me how it goes 🦋✨💅

📦 where this page comes from