XAPIAN-CHECK(1)

📦
version 2.0.0 · 9 versions
, in alpine 3.24

✨ NAME ✨ (XAPIAN-CHECK(1), from the User Commands manual)

Okay bestie, this is xapian-check — the tool that checks the consistency of a database or table. No cap, that's literally its whole thing. 💅

🦋 SYNOPSIS 🦋

xapian-check DATABASE_DIRECTORY|PATH_TO_BTREE [[F][t][f][b][v][+]]

You give it a DATABASE_DIRECTORY or a PATH_TO_BTREE, then optionally some little combo from [[F][t][f][b][v][+]]. 🎀

💖 DESCRIPTION 💖

xapian-check checks the consistency of a database or table. Yes, it's very much giving "I check consistency" and we love that for it. 💀✨

If a whole database is checked, then additional cross-checks between the tables are performed. So when you point it at the entire database, it also does extra cross-checks between the tables. 🔥

🌳 The btree(s) is/are always checked - control the output verbosity with:

  • F — attempt to fix a broken database (implemented for glass currently) 🛠️
  • t — short tree printing 🌱
  • f — full tree printing 🌳
  • b — show free blocks 🧱
  • v — show stats about B-tree (default) 📊
  • + — same as tbv ✨

Like, for example:

xapian-check /var/lib/xapian/data/default
xapian-check /var/lib/xapian/data/default/postlist fbv

💖 okay bye bestie — this iconic page is from xapian-core 2.0.0, March 2026. periodt. 💖

📦 where this page comes from