FSSYNC-DEBUG_VGCADD(8)

💖 FSSYNC-DEBUG_VGCADD 💖

okay bestie, this is a page from the AFS Command Reference — say hi to fssync-debug_vgcadd ✨

---

🌸 NAME 🌸

fssync-debug_vgcadd — adds an entry to the VG cache, a.k.a. the FSYNC_VG_UPDATE opcode 👑

---

🎀 SYNOPSIS 🎀

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

fssync-debug vgca
    -part <exact partition name>
    -pare <volume ID>
    -c <volume ID>
    [-r <sync protocol reason code>]
    [-pr <program type code>]
    [-h]

like yes, there are two forms, and the second one is the "my fingers are tired" version 🫶 (same command, shorter flags, no notes)

---

🦋 DESCRIPTION 🦋

The fssync-debug vgcadd command adds an entry to the volume group cache (VGC). that's it, that's the whole job, and it does it flawlessly 💅

---

✨ OPTIONS ✨

• -partition <exact partition name> — the exact partition name, like /vicepa. and when we say exact, we mean EXACT — abbreviations are not permitted, so don't try to be cute with it 🙈
• -parent <volume ID> — the numeric volume ID of the parent volume for the VGC entry 👑
• -child <volume ID> — the numeric volume ID of the child volume in the VGC entry 🍓
• -reason <sync protocol reason code> — the numeric sync protocol reason code. all the available codes are listed in the OpenAFS source file src/vol/fssync_inline.h. and for SYNC_REASON_NONE, you use -reason 0 💀 (yes, zero, that's the one)
• -programtype <program type code> — the program type code. permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. pick your fighter 🌈
• -help — prints the online help for this command. and it's so real of her: all other valid options are ignored when you do this 😌

---

👑 PRIVILEGE REQUIRED 👑

you gotta have write access to the file server for this one. usually that means you must be the local superuser "root" on the file server machine. so like… root energy, main character energy, no cap 🔥

---

💜 SEE ALSO 💜

fssync-debug_vgcdel(8), fssync-debug_vgcquery(8), fssync-debug_vgcscan(8), fssync-debug_vgcscanall(8)

(the whole vgc squad, obsessed with them fr fr)

---

🌸 COPYRIGHT 🌸

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. iconic behavior, respectfully 🫶

---

and that's the whole page bestie!! this one came from OpenAFS, dated 2026-07-27, and it lives in section 8 of the manual. go add some VGC entries, you absolute legend 💖✨🎀