OVDB_STAT(8)

🦋 OVDB_STAT(8) — ok bestie, let's peek inside the ovdb database

So this is ovdb_stat, part of the InterNetNews docs situation, and it's literally your little window into the ovdb database. Let's get into it 💅

---

✨ NAME ✨

ovdb_stat — display information from the ovdb database. That's it, that's the job, and she does it well 🫶

---

🌸 SYNOPSIS 🌸

ovdb_stat [-Hgci] [-r artnumrange] newsgroup [newsgroup ...]

ovdb_stat -HklmMtv [-d database]

Two whole modes, bestie. Pick your fighter ✨

---

💖 DESCRIPTION 💖

okay so ovdb_stat displays information from the ovdb database — and that means Berkeley DB statistics, newsgroup data, and overview records. You can optionally get the output in HTML format, which is lowkey iconic of her 🌈

Also, tiny side note you'll want in your notes app: the number of overview records stored in the database can be obtained with the inndf -n command. Different tool, same vibe, iykyk 👑

---

🎀 OPTIONS 🎀

• -g — shows you the newsgroup high water mark, low marker mark, article count, and flag for the newsgroups you name (as stored in the ovdb groupinfo database). Straight from the source, no cap 💅
• -c — similar to -g, except the high water mark, low water mark, and article count are calculated by actually scanning the overview records and counting them. Fr fr this can be a lengthy operation on groups with lots of articles, so maybe go get a snack 😭
• -i — displays internal data regarding the given newsgroups. The behind-the-scenes lore 🧚
• -r artnumrange — retrieves overview records! The artnumrange parameter may be a single article number, or a range of articles in the format low-high. Chef's kiss 🍓
• -H — output is presented in HTML format. Aesthetic mode: activated ✨
• -k — displays lock region statistics, as returned by the Berkeley DB lock_stat() call 🔥
• -l — displays log region statistics, as returned by the Berkeley DB log_stat() call 🌸
• -m — displays global memory pool statistics, as returned by the Berkeley DB memp_stat() call 💜
• -M — same as -m, and also displays memory pool statistics for each database file. She's thorough 👑
• -t — displays log region statistics, as returned by the Berkeley DB txn_stat() call ⭐
• -v — displays ovdb version, and Berkeley DB version. Version check, bestie 🌈
• -d database — displays information about the given database, as returned by the Berkeley DB db->stat() call. Heads up though: this operation may take a long time on busy systems (several minutes or more) — like, go touch grass and come back 💀

---

💀 WARNINGS 💀

okay this part matters, so listen up 🫶

ovdb_stat may be safely killed with the INT, TERM, or HUP signals. She catches those signals and exits cleanly — very demure, very mindful.

Do not kill ovdb_stat with other signals, unless absolutely necessary, because it may leave stale locks in the database environment. Not the vibe. Not the moment. 🙈

---

🌈 HISTORY 🌈

Written by Heath Kehoe <hakehoe@avalon.net> for InterNetNews. Giving credit where credit is due, periodt 💖

---

🦋 SEE ALSO 🦋

inndf(8), ovdb(5). Go read those too, bestie, they're part of the lore ✨

---

and that's the whole page!! brought to you by INN 2.7.4, dated 2023-03-19 — mwah, slay, go check your database 💅🎀