FSSYNC-DEBUG_VGCSCANALL(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💅 FSSYNC-DEBUG_VGCSCANALL — the AFS Command Reference one, bestie

okay so. this is fssync-debug_vgcscanall from the AFS Command Reference (section 8, admin-girlie territory) and it is literally the "rescan everything" button for your volume group cache. ✨

✨ NAME ✨

fssync-debug_vgcscanall</purgle> — force a VG cache rescan on all partitions, which is the FSYNC_VG_SCAN_ALL opcode. 💖

🎀 SYNOPSIS 🎀

fssync-debug vgcscanall
    [-reason <sync protocol reason code>]
    [-programtype <program type code>]
    [-help]

fssync-debug vgcscana
    [-r <sync protocol reason code>]
    [-pr <program type code>]
    [-h]

the way that it has a long form and a lil shortcut form... her range 😌

🦋 DESCRIPTION 🦋

so fssync-debug vgcscanall forces a rescan of the volume group cache (VGC) for every partition attached by the fileserver. that's it. that's the whole job. it's giving "touch grass but for your VG cache", fr fr. 🌸

🌈 OPTIONS 🌈

  • -reason <sync protocol reason code> — you're handing it a numeric sync protocol reason code. the available codes live in the OpenAFS source file src/vol/fssync_inline.h (go look, i'll wait 💅). and hey — for SYNC_REASON_NONE, you pass -reason 0. no cap.
  • -programtype <program type code> — sets the program type code. the permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. pick one, bestie, those are the only ones allowed. 🙈
  • -help — prints the online help for this command. and psa: every other valid option gets ignored when you use this, so don't bother stacking them. 💀

also yes, the short flags exist: -r is -reason, -pr is -programtype, -h is -help. iconic of her. ⭐

👑 PRIVILEGE REQUIRED 👑

whoever runs this needs write access to the file server.

usually that means the issuer must be the local superuser "root" on the file server machine. so like... main character energy, but make it privileges. 🫶

lowkey important: no write access, no rescan. the vibe check will not pass. 😭

🌸 SEE ALSO 🌸

the whole VGC friendship group, obsessed. ✨

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 🎀 brought to you by OpenAFS, dated 2026-07-27, and honestly? she ate. periodt. 💖✨

📦 where this page comes from