FSSYNC-DEBUG_QUERY(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 FSSYNC-DEBUG_QUERY — the fssync-debug query page, but make it make sense

okay bestie, welcome to the AFS Command Reference 💖 this is the page for fssync-debug_query, and yes, that hyphenation is real, we don't make the rules, we just vibe with them. ✨

🦋 NAME

fssync-debug_query — no cap, this one displays volume structure. That's it, that's the whole job. It's the FSYNC_VOL_QUERY opcode doing its little thing. 👑

✨ SYNOPSIS

Like. here's how you actually call her. Three spellings, same energy:

fssync-debug query -volumeid <volume ID>
    [-partition <exact partition name>]
    [-reason <sync protocol reason code>]
    [-programtype <program type code>]
    [-help]
fssync-debug q -v <volume ID>
    [-pa <exact partition name>]
    [-r <sync protocol reason code>]
    [-pr <program type code>]
    [-h]
fssync-debug qry -v <volume ID>
    [-pa <exact partition name>]
    [-r <sync protocol reason code>]
    [-pr <program type code>]
    [-h]

notice how query, q and qry are literally the same girl in three outfits 🌸 and -v, -pa, -r, -pr, -h are just the abbreviated lewks. iconic.

🎀 DESCRIPTION

The fssync-debug query command displays volume structure. that's the tea 🍓 (yes, I said it twice, it's that important, and it's that short)

🌈 OPTIONS

one bullet per flag, no skipping, we are thorough in this house 💜

  • -volumeid <volume ID> — you give her the numeric volume ID. that's it. volume names? not permitted, bestie. numbers only, the CLI is not doing name resolution today 😭 (this one shortens to -v)
  • -partition <exact partition name> — the exact partition name, like /vicepa. abbreviations are not permitted — do not try to be cute with it, she will not guess 🙈 (short form: -pa)
  • -reason <sync protocol reason code> — a numeric sync protocol reason code. the available codes are listed in the OpenAFS source file src/vol/fssync_inline.h if you wanna go look at the lore 📖 and for SYNC_REASON_NONE, you pass -reason 0. yes, zero. that's the move. (short form: -r)
  • -programtype <program type code> — the program type code. the permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. pick one, six options, all valid 🫶 (short form: -pr)
  • -help — prints the online help for this command. and lowkey the icon behavior here: all other valid options are ignored. so you can absolutely spam flags next to -help and she'll just print help and move on 💀 (short form: -h)

🔥 PRIVILEGE REQUIRED

bestie, you need write access to the file server for this. usually that means you've gotta be the local superuser "root" on the file server machine. so like. no random user energy in here please, this is root's house 👑

🧚 SEE ALSO

go read these next, they're the sibling pages and they ate:

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. absolute legends, we love a documentation credit chain 🙏

okay that's the whole page, you're officially done 💖 this came to you from OpenAFS, dated 2026-07-27, and honestly? slay. go query some volume structure, bestie. ✨🦋

📦 where this page comes from