FSSYNC-DEBUG_VGCSCAN(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

✨ fssync-debug_vgcscan — the vibe-coded VG cache rescan 💅

okay so bestie, this is a page straight out of the AFS Command Reference, section 8 (that's the sysadmin-y one 🧚), and it's called fssync-debug_vgcscan. She's got exactly one job and she does it flawlessly.

🌸 NAME 🌸

fssync-debug_vgcscan — force a VG cache rescan (the FSYNC_VG_SCAN opcode, iykyk)

🎀 SYNOPSIS 🎀

fssync-debug vgcscan
    -partition <exact partition name>
    [-reason <sync protocol reason code>]
    [-programtype <program type code>]
    [-help]

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

🦋 DESCRIPTION 🦋

The fssync-debug vgcscan command forces a rescan of the volume group cache (VGC) for a particular partition. That's it, that's the whole assignment. She walks in, she rescans one partition's VGC, she leaves. main character energy fr fr 👑

✨ OPTIONS ✨

  • -partition <exact partition name> — tells her exactly which partition to look at, like /vicepa. and listen, it has to be the exact name. Abbreviations are not permitted. no shortcuts, no nicknames, no "you know the one" 🚫
  • -reason <sync protocol reason code> — drops in a numeric sync protocol reason code. All the available codes are listed over in the OpenAFS source file src/vol/fssync_inline.h if you wanna go read the receipts yourself. And for SYNC_REASON_NONE, you pass -reason 0. iconic.
  • -programtype <program type code> — sets 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 here's the thing: all other valid options are ignored when you do this. she does not multitask. she helps, and that's all. 💖

🔥 PRIVILEGE REQUIRED 🔥

The issuer must have write access to the file server. Usually that means the issuer has to be the local superuser root on the file server machine. so like… bring your root privileges or don't come at all 🙈

🌈 SEE ALSO 🌈

(the whole VGC friend group, they're a package deal 🫶)

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 💜 shoutout to OpenAFS, dated 2026-07-27, version vibes ✨ no cap, whether you needed -pa or the long way around, she ate and left no crumbs 🍓💅

📦 where this page comes from