FSSYNC-DEBUG_ONLINE(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 FSSYNC-DEBUG_ONLINE 💖

okay bestie, so this is a page from the AFS Command Reference — it's FSSYNC-DEBUG_ONLINE(8) and it's literally about bringing a volume back online. put your hair up, we're doing fileserver surgery 🫶

✨ NAME ✨

fssync-debug_online — brings a volume online (the FSYNC_VOL_ON opcode, no cap 💅)

🌸 SYNOPSIS 🌸

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

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

see how online and on are the same thing? and every long flag has a lil short-flag bestie? iconic behavior honestly 🎀

🦋 DESCRIPTION 🦋

The fssync-debug online command brings a volume online. that's it, that's the whole job. she's awake. she's up. she's serving. periodt 💅

💜 OPTIONS 💜

  • -volumeid <volume ID> — the numeric volume ID goes here. that's numeric only, bestie — volume names are not permitted. so no cute nicknames, just numbers 🙈
  • -partition <exact partition name> — the exact partition name (like /vicepa). and when we say exact, we mean exact — abbreviations are not permitted. no shortcuts, no vibes-based guessing 🌸
  • -reason <sync protocol reason code> — the numeric sync protocol reason code. all the available codes are listed over in the OpenAFS source file src/vol/fssync_inline.h. if you want SYNC_REASON_NONE, you use -reason 0. easy math, slay ✨
  • -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 heads up: all other valid options are ignored when you do this. she only has eyes for help 😭

👑 PRIVILEGE REQUIRED 👑

The issuer must have write access to the file server. Usually, this means that the issuer must be the local superuser "root" on the file server machine.

so like… root energy only. main character access. if you're not root, this is not your moment, and that's okay 💀

🌈 SEE ALSO 🌈

the whole fssync-debug friend group 🫶 go read them all, iykyk

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 one shipped as part of OpenAFS, dated 2026-07-27 — go bring a volume online and be the icon you were born to be 🎀💅✨

📦 where this page comes from