FSSYNC-DEBUG_STATS(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 FSSYNC-DEBUG_STATS(8) — the AFS Command Reference girlies know 💅

okay bestie, sit DOWN, because we're about to get into fssync-debug_stats, aka the little stats-gremlin of the fssync-debug family, from the AFS Command Reference. it's giving "I just want to see the numbers" energy and honestly? iconic. 🎀

✨ NAME ✨

fssync-debug_stats — literally just displays various statistics. that's it. that's the whole job. no cap. 📊

🌸 SYNOPSIS 🌸

fssync-debug stats -cmd <subcommand>
    [-arg1 <arg1>]
    [-arg2 <arg2>]
    [-reason <sync protocol reason code>]
    [-programtype <program type code>]
    [-help]

fssync-debug s -c <subcommand>
    [-arg1 <arg1>]
    [-arg2 <arg2>]
    [-r <sync protocol reason code>]
    [-p <program type code>]
    [-h]

so yes, stats and s are the same thing, and -cmd and -c are the same thing, etc etc — same girl, different outfits. 💖

🦋 DESCRIPTION 🦋

the fssync-debug stats command displays statistics. which statistics, you ask? however many the value of the -cmd option tells it to show you. that's the whole vibe check: -cmd picks the flavor, and you get the numbers. 🫶

👑 OPTIONS 👑

  • -cmd <subcommand> — tells it WHICH statistics subcommand you want, bestie. the available subcommands are:
    • pkg — general volume package statistics ✨
    • vicep — vice partition statistics 💜
    • hash — volume hash chain statistics 🌈
    • hdr — volume header cache statistics 🎀
    • vlru — vlru generation statistics 🦋
    • help — displays the list of available subcommands 🆘
  • -arg1 <arg1> — your first optional argument, and what it means depends on which subcommand you picked, iykyk. for vicep statistics it's the partition name; for hash statistics it's the hash bucket number; for vlru statistics it's the vlru generation number. one arg, three possible personalities. 💅
  • -arg2 <arg2> — your second optional argument, also interpreted in the context of the chosen subcommand. and ngl? currently none of the subcommands use it. it's just standing there, existing, serving nothing. 💀
  • -reason <sync protocol reason code> — sets a numeric sync protocol reason code. the available codes are listed in the OpenAFS source file src/vol/fssync_inline.h. and for SYNC_REASON_NONE, you use -reason 0. (0 is the "no reason, just vibes" code, fr fr.) 🔥
  • -programtype <program type code> — sets the program type code. permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. pick your main character. ⭐
  • -help — prints the online help for this command. and the way it does NOT care about your other options — all other valid options are ignored. periodt. 🙈

🔐 PRIVILEGE REQUIRED 🔐

the issuer must have write access to the file server. usually that means the issuer has to be the local superuser "root" on the file server machine. so like… root, or nothing. no in-between, bestie. 👑

🎀 SEE ALSO 🎀

go read those too, don't be a stranger to the family. 🫶

Copyright 2010 Davor Ocelic <docelic@spinlocksolutions.com>

this documentation is covered by the IBM Public License Version 1.0. this man page was written by Davor Ocelic for OpenAFS, based on documentation from Steven Jenkins, Tom Keiser and Simon Wilkinson. absolute legends, honestly, we stan. 💖

and that's the whole page, bestie!! OpenAFS, 2026-07-27 — that's the source, the version and the date all wrapped up in a bow 🎀 go forth and check your stats, you gorgeous fssync-debug-enjoying icon. mwah. 💅✨

📦 where this page comes from