FSSYNC-DEBUG_LEAVEOFF(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 fssync-debug_leaveoff — the AFS Command Reference tea 💖

okay bestie, so this is fssync-debug_leaveoff from the AFS Command Reference, section 8 (that's the admin-commands girlies, iykyk). Sit down, grab a strawberry matcha, we're doing low-level volume stuff and honestly? it's kind of iconic. ✨

🌸 NAME 🌸

fssync-debug_leaveoff — she leaves a volume offline, no cap. Internally that's the FSYNC_VOL_LEAVE_OFF opcode, and yes the spelling really is leaveoff, not leave off, we don't make the rules. 🫶

🦋 SYNOPSIS 🦋

the full-name version, serving long-form main character energy:

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

and the abbreviated version, for when you're typing fast and DGAF:

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

same command, same vibes, just shorter. both are valid, both slay.

💅 DESCRIPTION 💅

fssync-debug leaveoff leaves a volume offline. that's it. that's the whole plot. the volume goes offline, she said "not today" and dipped. 💀

✨ OPTIONS ✨

every single one, in order, no skipping, we're thorough like that:

  • -volumeid <volume ID> — give her the numeric volume ID. and hear me on this: volume names are NOT permitted, numbers only, periodt. don't try to be cute with the name, she will not accept it. 🙈
  • -partition <exact partition name> — the exact partition name, like /vicepa — spelled out fully. abbreviations are not permitted, not even a little one. the full name or nothing, bestie. 🎀
  • -reason <sync protocol reason code> — the numeric sync protocol reason code. all the available codes are listed in the OpenAFS source file src/vol/fssync_inline.h — go look, it's the lore. and if you want SYNC_REASON_NONE, you use -reason 0. zero is a valid reason code, she contains multitudes. 🌈
  • -programtype <program type code> — the program type code. permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. pick one, any one, they're all welcome here. 🌟
  • -help — prints the online help for this command, and every other valid option just gets ignored. sorry to the other options, this one's the main character rn. all other valid options are ignored. 💫

👑 PRIVILEGE REQUIRED 👑

whoever runs this must have write access to the file server. and usually? that means the issuer has to be the local superuser root on the file server machine. so like... root privileges or you're just a spectator, fr fr. don't be out here trying to run it as a random user, it's not gonna hit. 🚫

🔥 SEE ALSO 🔥

go read her friends, they're all in 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.

and that's the whole thing, bestie!! 🎀 written by Davor Ocelic, version vibes from OpenAFS, dated 2026-07-27 — you're all caught up, now go leave that volume offline responsibly. mwah. 💖✨🦋

📦 where this page comes from