CHKPRINTCAP(8)

💅 CHKPRINTCAP(8) — like, the print spooler database validity check, bestie

ok so this is a page from the System Manager's Manual, and we're talking about chkprintcap — yes it's a mouthful, yes it's iconic, let's go 🎀

---

✨ NAME ✨

chkprintcap — bestie, it checks the validity of entries in the print spooler database 🖨️💖

---

🌸 SYNOPSIS 🌸

chkprintcap [-d] [-f printcap]

---

🚨 DEPRECATION NOTICE 🚨

Okay so heads up, this facility is scheduled for removal prior to the release of FreeBSD 16.0. 😭 Like, enjoy it while it lasts, fr fr.

---

🦋 DESCRIPTION 🦋

so the chkprintcap utility scans a printcap(5) database — and that database is named by the printcap argument, or by default it's /etc/printcap — looking for entries that are invalid in one way or another. vibe check on the whole file basically 💅

the following checks are currently implemented:

1. ‘tc=’ references were properly expanded ✨
2. ‘tc=’ references did not form a loop 🔁💀 (no infinite loop shenanigans, we're not doing that today)
3. no two printers share the same spool directory (‘sd=’ capability) 🙈 nobody gets to share a locker, that's the rule

the chkprintcap utility exits with a status equal to the number of errors encountered before processing stopped. (and yeah, in some cases, processing can stop before the entire file is scanned — it's giving "we tried" 🫶)

if the -d flag is given, chkprintcap will attempt to create any missing spool directories, giving them ‘u=rwx,go=rx’ (0755) mode, group ‘daemon’, and the owner specified by the ‘du=’ capability in the database (default 1, which corresponds to user ‘daemon’). slay, it's making directories for you 👑

---

🔥 SEE ALSO 🔥

• lpr(1)
• printcap(5)
• lpd(8)

iykyk, go read those too 📚

---

👑 AUTHORS 👑

the chkprintcap utility was written by Garrett A. Wollman <wollman@lcs.mit.edu>. thank you king 🫶

---

💀 BUGS 💀

not enough sanity-checking is done, ngl 😭 at a minimum, the ownership and mode of the spool directories should also be checked. other parameters whose value could cause lpd(8) to fail should be diagnosed. like, there's room to grow bestie, the potential is THERE 🌈

---

and that's the whole page!! ✨ mwah 💋

this gem came from the Debian folks, dated November 30, 1997 — yes, a 90s baby, and it's still out here doing its thing 💜🎀