FSSYNC-DEBUG_DETACH(8)

✨ FSSYNC-DEBUG_DETACH 💅

okay so bestie, welcome to fssync-debug_detach — it's a page straight out of the AFS Command Reference and today we are DETACHING a volume. yes. detaching. putting it down. releasing it into the wild. 🦋

---

🌸 NAME 🌸

fssync-debug_detach — detaches a volume (the FSYNC_VOL_DONE opcode, iykyk 👑)

---

🎀 SYNOPSIS 🎀

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

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

like, you can spell everything out OR you can be lazy and use the short forms. both are valid, both are iconic. 🫶

---

💖 DESCRIPTION 💖

The fssync-debug detach command detaches a volume.

that's it. that's the whole vibe. not me writing three sentences about a one-sentence command 😭

---

✨ OPTIONS ✨

• -volumeid <volume ID> — the numeric volume ID goes here. and listen: volume names are not permitted, it has to be the number fr fr 🔢
• -partition <exact partition name> — the exact partition name, like /vicepa. no abbreviations, no shortcuts, no "you know what I meant" — it's giving strict 🚫
• -reason <sync protocol reason code> — a numeric sync protocol reason code. the available codes are living their best life over in the OpenAFS source file src/vol/fssync_inline.h. and for SYNC_REASON_NONE you use -reason 0, okay? 💯
• -programtype <program type code> — the program type code. the permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. pick your main character 🌈
• -help — prints the online help for this command. and every other valid option? ignored bestie, they don't even get a glance 👀

---

👑 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 energy only, we don't let just anyone in 💅

---

🌈 SEE ALSO 🌈

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

(the whole fssync-debug friend group honestly, they all hang out together 🫶)

---

🍓 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!! OpenAFS, 2026-07-27 — go forth and detach responsibly. slay 🎀✨