FSSYNC-DEBUG_CALLBACK(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 FSSYNC-DEBUG_CALLBACK — the AFS Command Reference, section 8, bestie 💅

okay so real talk, this one lives in section 8 of the AFS Command Reference, which is the "admin tools, handle with care" corner of the man page universe. it's a debug tool. it breaks callbacks. it is not a chill little command you run for funsies. but it slays at exactly one job and we're gonna learn it together 🫶

✨ NAME ✨

fssync-debug_callback — breaks callbacks for a volume, and yes it is literally the FSYNC_VOL_BREAKCBKS opcode in a trench coat 💅

🌸 SYNOPSIS 🌸

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

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

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

so you got three whole ways to say its name: callback, ca, and cbk — the command is giving "I have many nicknames and I answer to all of them" energy ✨ and every single flag has a glow-down short form too. use whichever one your fingers remember at 3am.

🦋 DESCRIPTION 🦋

The fssync-debug callback command breaks callbacks for a volume.

that's it. that's the whole thing. it walks in, it breaks the callbacks for that volume, it leaves. no notes. lowkey iconic honestly.

🎀 OPTIONS 🎀

  • -volumeid <volume ID> — hands over the numeric volume ID. and bestie, listen: volume names are not permitted. numeric only. do not try to be cute with a name here, it will not work 🙈
  • -partition <exact partition name> — the exact partition name, like /vicepa. abbreviations are NOT permitted — it wants the whole thing spelled out, no shortcuts, no vibes-based guessing 💀
  • -reason <sync protocol reason code> — the numeric sync protocol reason code. the available codes are listed over in the OpenAFS source file src/vol/fssync_inline.h. and for SYNC_REASON_NONE, you use -reason 0. zero. that's your "no reason" reason, iykyk 🌈
  • -programtype <program type code> — the program type code. permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. six options, pick one, no free-styling 🎀
  • -help — prints the online help for this command. and here's the gag: all other valid options are ignored. so you can pile on every flag you want and -help will simply not care. main character energy fr fr 👑

💜 PRIVILEGE REQUIRED 💜

The issuer must have write access to the file server. usually that means the issuer must be the local superuser root on the file server machine.

so yeah, this is a root-only situation. if you're not root on that box, this command is not for you and it will let you know 😭

🔥 SEE ALSO 🔥

the whole extended fam, go read all of them:

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.

shoutout to Davor, Steven, Tom and Simon for writing it all down so we could be here today 🫶

and that's the whole page, bestie ✨ no cap, you now know fssync-debug_callback better than most people know their own wifi password. go break some callbacks responsibly 💖

OpenAFS — 2026-07-27 — FSSYNC-DEBUG_CALLBACK(8) 🎀🦋💅

📦 where this page comes from