STATE_ANALYZER(8)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

✨ state_analyzer ✨ (that's the STATE_ANALYZER(8) page, AFS Command Reference obvi)

okay bestie, pull up a chair, because today we're looking at state_analyzer and she is a lot 💅

🌸 NAME 🌸

state_analyzer — Explores and queries the fileserver state database interactively

🦋 SYNOPSIS 🦋

state_analyzer [state dump file | -h]

💖 DESCRIPTION 💖

So the demand-attach file server is out here making host / callback information persistent, like it refuses to forget its exes. On shutdown, the state gets saved to the database fsstate.dat(5). On startup, the state is read, verified and restored. And why do we care?? Because this lets you do file server shutdowns or restarts without breaking all callbacks — which, lowkey, is an operation that could otherwise take a long time. no cap, we're saving you hours here 🫶

state_analyzer interactively explores and queries that saved state database, fsstate.dat(5). it's giving detective energy, fr fr 🔍

heads up bestie ⚠️ this command is only supported on the demand-attach file server. It operates at an extremely low-level and hence requires detailed knowledge of the OpenAFS architecture and code. like, not a beginner vibe. you've been warned 💀

🎀 COMMANDS 🎀

state_analyzer supports the following interactive commands:

👑 h <...> — host menu

  • hdr — display the host_state_header struct
  • first — display the first host
  • prev — display the previous host
  • this — display this host
  • next — display the next host
  • last — display the last host
  • dump — display all hosts

🌈 fe <...> — FileEntry menu

  • hdr — display the callback_state_header struct
  • first — display the first FE
  • prev — display the previous FE
  • this — display this FE
  • next — display the next FE
  • last — display the last FE
  • dump — display all FEs
  • timeout — display the timeout queue heads
  • hash — display the file entry hash buckets
  • find by index id — find an fe by its array index
  • find by fid (vol,vnode,unique) — find an fe by its AFSFid

🍓 cb <...> — CallBack menu

  • hdr — display the callback_state_entry_header struct
  • first — display the first CB
  • prev — display the previous CB
  • this — display this CB
  • next — display the next CB
  • last — display the last CB
  • dump — display all CBs

✨ and the rest of the squad ✨

  • hexdump [offset [len]] — hex dump raw data
  • quit — quit current menu
  • exit — exit debugger
  • help — help message

🔐 PRIVILEGE REQUIRED 🔐

The issuer must have read access to the file server state database, fsstate.dat. Usually, this means that the issuer must be the local superuser "root" on the file server machine. so yeah, root energy only, sorry to everyone else 😭

👀 SEE ALSO 👀

fsstate.dat(5), fssync-debug(8), salvsync-debug(8)

go read those too, they're part of the lore iykyk 📚

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 Tom Keiser, Steven Jenkins and others. shoutout to the whole crew, iconic behaviour honestly 🫡

okay that's the whole page bestie, you ate 💅 this was OpenAFS, dated 2026-07-27, and it lives at STATE_ANALYZER(8). mwah, go forth and never break a callback again 🦋✨

📦 where this page comes from