FSSYNC-DEBUG_LIST(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 FSSYNC-DEBUG_LIST — from the AFS Command Reference (section 8) 🎀

okay bestie, sit down, hydrate, and let me tell you about the most chaotic little command in the AFS cinematic universe 💖

✨ NAME ✨

fssync-debug_list — the historical sync command (it calls the FSYNC_VOL_LISTVOLUMES opcode, if you were wondering 👀)

🌸 SYNOPSIS 🌸

fssync-debug list -volumeid <volume ID>
    [-partition <exact partition name>]
    [-reason <sync protocol reason code>]
    [-programtype <program type code>]
    [-help]

fssync-debug li -v <volume ID>
    [-pa <exact partition name>]
    [-r <sync protocol reason code>]
    [-pr <program type code>]
    [-h]

fssync-debug ls -v <volume ID>
    [-pa <exact partition name>]
    [-r <sync protocol reason code>]
    [-pr <program type code>]
    [-h]

like yes, there are three whole ways to write it and yes, li and ls are just list wearing a tiny disguise 🫶 iykyk

🦋 DESCRIPTION 🦋

okay so here's the tea, and it's honestly kind of iconic in a "nothing happens" way ☕

fssync-debug list... does nothing. like, genuinely. it returns success, as long as the fileserver is available, and that's the entire show. the opcode it calls is hanging around purely for historical reasons, and it now does nothing.

that's it. that's the command. lowkey the most unbothered behaviour i've ever witnessed 💀✨ it still shows up, it still looks important, it still says "yes" — and it does nothing. main character energy honestly 👑

🎀 OPTIONS 🎀

  • -volumeid <volume ID> — bestie, this is the numeric volume ID. and i mean numeric. volume names are not permitted, so don't even try it 🙈
  • -partition <exact partition name> — the exact partition name, like /vicepa. exact exact. abbreviations are not permitted, so no little nicknames for your partitions 💅
  • -reason <sync protocol reason code> — a numeric sync protocol reason code. the available codes are listed up in the OpenAFS source file src/vol/fssync_inline.h 📚 and hey, if you want SYNC_REASON_NONE, that's -reason 0.
  • -programtype <program type code> — the program type code. the permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. pick your fighter ⭐
  • -help — prints the online help for this command. and plot twist: every other valid option gets ignored when you use it, so don't bother pairing it with anything else 😭

👑 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, this is a you-need-the-keys moment 🔑

🌈 SEE ALSO 🌈

go read the rest of the family fr fr 🫶

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, all of them 🌟

and that's the whole page, bestie 🎀💖 this was OpenAFS, dated 2026-07-27 — periodt ✨

📦 where this page comes from