FSSYNC-DEBUG_MODE(8)

💅 FSSYNC-DEBUG_MODE 💅

okay bestie, so this is a page from the AFS Command Reference — it's the fssync-debug_mode command, and honestly? it's giving "tiny command, big consequences." let's get into it 🫶

---

✨ NAME ✨

fssync-debug_mode — changes volume attach mode (the FSYNC_VOL_NEEDVOLUME opcode, iykyk)

---

🎀 SYNOPSIS 🎀

like, here's every single way you're allowed to call it. all of these are the same command wearing different outfits 💅

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

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

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

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

so mode, mod, needvolume and n are all nickname-nicknames of each other, and the flags have short forms too. slay. 👑

---

🌸 DESCRIPTION 🌸

the fssync-debug mode command changes volume attach mode. that's the whole vibe. short, iconic, does exactly one thing. ✨

---

💖 OPTIONS 💖

• -volumeid <volume ID> — gives the numeric volume ID. and no, bestie, volume names are not permitted here. numbers only, it's very strict about it. 🔢
• -partition <exact partition name> — the exact partition name, like /vicepa. abbreviations are not permitted, so don't try to be cute and shorten it, it will not work. 🙈
• -reason <sync protocol reason code> — the 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. noted. 📝
• -programtype <program type code> — the program type code. permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. like, all six of them, pick one. 🌈
• -help — prints the online help for this command. and listen, all other valid options get ignored when you do this, so don't bother stacking them. 💅

---

👑 PRIVILEGE REQUIRED 👑

whoever's running this 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… bestie. be careful. main character energy comes with main character responsibility. 😭

---

🦋 SEE ALSO 🦋

fssync-debug_attach(8), fssync-debug_detach(8), fssync-debug_callback(8), fssync-debug_online(8), fssync-debug_offline(8), fssync-debug_error(8)

go read those too, the whole little friend group is cute. 🫶

---

💜 COPYRIGHT 💜

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.

---

and that's the whole page, bestie!! 🌈💖 this came out of OpenAFS, dated 2026-07-27, and if you ever forget a flag just run -help and let the docs carry you. periodt. ✨🎀🦋