FSSYNC-DEBUG_HEADER(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 fssync-debug_header — the AFS Command Reference ✨

okay bestie, welcome to the fssync-debug_header page, aka section 8 of the AFS Command Reference 🎀 this one is short and sweet and it's literally just "hey, show me the volume disk data structure" 🦋

🌸 NAME 🌸

fssync-debug_header — retrieves volume disk data structure, and the opcode doing the actual work behind the curtain is FSYNC_VOL_QUERY_HDR 💅

✨ SYNOPSIS ✨

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

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

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

like yes, the command name is three whole syllables and the shell is NOT about that life, so hea and hdr are right there for you, no cap 🙈

💜 DESCRIPTION 💜

The fssync-debug header command retrieves volume disk data structure. that's it. that's the whole job. it's giving "one task, done flawlessly" energy 👑

🩷 OPTIONS 🩷

  • -volumeid <volume ID> — specifies the numeric volume ID. and no, bestie, volume names are not permitted here 😭 it's numbers only, fr fr.
  • -partition <exact partition name> — specifies the exact partition name (e.g. /vicepa). Abbreviations are not permitted, so don't try to get cute with it 💀
  • -reason <sync protocol reason code> — specifies numeric sync protocol reason code. the available codes are listed in the OpenAFS source file src/vol/fssync_inline.h (iykyk, go read the source). For SYNC_REASON_NONE, use -reason 0.
  • -programtype <program type code> — specifies program type code. permitted values are fileServer, volumeUtility, salvager, salvageServer, volumeServer and volumeSalvager. pick your fighter 🌈
  • -help — prints the online help for this command. All other valid options are ignored. classic help behavior, it does not care about your other flags, it's the main character now 🫶

🔐 PRIVILEGE REQUIRED 🔐

The issuer must have write access to the file server. Usually, this means that the issuer must be the local superuser root on the file server machine. so yeah, unless you're root on the box itself, this is not your moment 😭

lowkey important: it's write access to the file server, and usually that means being local root on the file server machine. no skipping this one bestie 💅

👀 SEE ALSO 👀

go read those too, they're the sibling chapters 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 stan 💖

and that's the whole page bestie, no crumbs left 🍓 this was OpenAFS, dated 2026-07-27, and it's the FSSYNC-DEBUG_HEADER(8) page — slay, bye 💅✨

📦 where this page comes from