FSSYNC-DEBUG_VGCQUERY(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 FSSYNC-DEBUG_VGCQUERY — ok bestie, let's peek inside the VG cache ✨

so this is a page from the AFS Command Reference, and it's the glow-up guide for fssync-debug_vgcquery. yes the name is a mouthful. yes it's iconic anyway. 🫶

🌸 NAME 🌸

fssync-debug_vgcquery — literally just displays what's sitting in the VG cache, using the FSYNC_VG_QUERY opcode 💖

🦋 SYNOPSIS 🦋

ok so there's three whole ways to spell this and they all do the same thing, no cap:

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

like, pick your fighter. vgcquery, vgcq, vgcqry — same energy, different fonts 💜

✨ DESCRIPTION ✨

The fssync-debug vgcquery command shows you an entry from the volume group cache (the VGC, iykyk), and it might also kick off a VGC scan if that's the appropriate move. so yeah — it's giving "look at this one thing" but also "and maybe we go shopping for more" 🛍️

👑 OPTIONS 👑

  • -partition <exact partition name> — you give it the exact partition name, like /vicepa. and bestie, abbreviations are NOT permitted. it wants the whole thing, spelled out, no shortcuts 🙅‍♀️
  • -volumeid <volume ID> — the numeric volume ID please. volume names? not permitted. numbers only, periodt 🔢
  • -reason <sync protocol reason code> — a numeric sync protocol reason code. all the available codes are listed in the OpenAFS source file src/vol/fssync_inline.h. and if you want SYNC_REASON_NONE, you use -reason 0. easy 🌈
  • -programtype <program type code> — the program type code. the permitted values are exactly these: fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. that's the whole list, don't freestyle 💀
  • -help — prints the online help for this command. and heads up: all other valid options are ignored when you do this. so don't be out here passing -partition and -help together expecting both to happen 🙈

🔐 PRIVILEGE REQUIRED 🔐

whoever runs this needs write access to the file server. usually that means you gotta be the local superuser root on the file server machine itself. main character energy only, sorry 😭👑

🎀 SEE ALSO 🎀

go read the rest of the family, they're all slaying in their own way:

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. absolute legends, we love a credited author 🫶✨

and that's the whole page, bestie!! this one comes from OpenAFS, dated 2026-07-27 — so if you're reading this from the future, hi, you're doing great, go query that VGC 💅🌟

📦 where this page comes from