---
name: "state_analyzer"
section: "8"
platform: "linux"
package: "openafs-fileserver"
version: "1.8.13.2-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/state_analyzer"
---

# state\_analyzer(8)

Explores and queries the fileserver state database interactively

## NAME

state\_analyzer - Explores and queries the fileserver state database interactively

## SYNOPSIS

**state\_analyzer** \[*state dump file* \| **-h**\]

## DESCRIPTION

The demand-attach file server makes host / callback information persistent. On shutdown, the state is saved to database **fsstate.dat**(5). On startup, the state is read, verified and restored. This allows for file server shutdowns or restarts without breaking all callbacks (an operation that could otherwise take a long time).

**state\_analyzer** interactively explores and queries the saved state database, **fsstate.dat**(5).

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.

## 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

- **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.

## SEE ALSO

**fsstate.dat**(5), [**fssync-debug**(8)](/fssync-debug/8.md), **salvsync-debug**(8)

## COPYRIGHT

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.