FSSYNC-DEBUG_VOLOP(8)

πŸ’… FSSYNC-DEBUG_VOLOP πŸ’…

okay bestie, so this is a page from the AFS Command Reference β€” aka the fssync-debug volop corner of the OpenAFS universe 🫢

✨ NAME ✨

fssync-debug_volop β€” it shows you the pending volume operation info, no cap. (specifically it's the FSYNC_VOL_QUERY_VOP opcode, iykyk)


🌸 SYNOPSIS 🌸

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

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

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

yes babe, [-h] is listed twice at the end there, and we are NOT editing it, we are respecting the source material πŸ’€


πŸ¦‹ DESCRIPTION πŸ¦‹

The fssync-debug volop command displays information about the pending volume operation for a given volume, if any.

that's it. that's the whole vibe. you point it at a volume, it tells you what operation is queued up waiting on that volume. if there's nothing pending? well, it shows you nothing pending. iconic behavior honestly ✨


πŸ‘‘ OPTIONS πŸ‘‘

  • -volumeid <volume ID> β€” specifies the numeric volume ID. Volume names are NOT permitted. numbers only bestie, don't try it πŸ™ˆ
  • -partition <exact partition name> β€” specifies the exact partition name, like /vicepa. Abbreviations are not permitted β€” it wants the whole thing, spelled all the way out, no shortcuts πŸ’…
  • -reason <sync protocol reason code> β€” specifies a numeric sync protocol reason code. The available codes are listed in the OpenAFS source file src/vol/fssync_inline.h. For SYNC_REASON_NONE, use -reason 0. πŸ“œ
  • -programtype <program type code> β€” specifies a 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. All other valid options are ignored. so like, don't bother passing anything else alongside it, it's not gonna read them 🫢

πŸ”’ PRIVILEGE REQUIRED πŸ”’

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

so like... not a casual thing. you gotta be that girl (root) on that machine (the file server). no cap 😭

🌈 SEE ALSO 🌈

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

the whole fssync-debug friend group, go say hi πŸ’–


Copyright 2010 Sine Nomine Associates

This documentation is covered by the IBM Public License Version 1.0. This man page was written by Andrew Deason and Davor Ocelic for OpenAFS.


and that's the whole page bestie, you ate that reading session fr fr πŸ’…βœ¨

this was OpenAFS, dated 2026-07-27 β€” mwah, bye 🫢🌸

πŸ“¦ where this page comes from