CHKGRP(8)

💅 CHKGRP, bestie — the group file's personal hype-checker (section 8 of your system manager's manual, mwah)

okay so picture this: it's a manual page, it's in section 8, it's called chkgrp, and it's here to make sure your group file isn't out here embarrassing itself. welcome to the vibe check 🎀

---

✨ NAME ✨

chkgrp — check the syntax of the group file. that's it, that's the whole job, and she does it flawlessly 💁‍♀️

---

🌸 SYNOPSIS 🌸

chkgrp [-q] [groupfile]

---

🦋 DESCRIPTION 🦋

okay so the chkgrp utility (yes, utility, she's an icon) scans the file you hand her — or, if you don't hand her one, the system-wide group file — and hunts for errors like it's her whole personality. and honestly? it is.

specifically, she checks that:

• every non-blank, non-comment entry is made of four colon-separated fields — four, no more, no less, we don't do chaotic field counts here
• none of those fields contain whitespace, like, at all, not even a lil space
• the third field (that's the group ID, iykyk) is numeric

she'll also check for invalid characters in the group names and group members, because someone has to 🫶

the following options are available:

• -q — this option disables printing of text when the group format is correct. so she just... says nothing. silent queen behaviour. if something's wrong she'll still absolutely tell you 💀

---

🎀 FILES 🎀

• /etc/group — the group database file, aka the main character of this whole situation 👑

---

🌈 EXIT STATUS 🌈

the chkgrp utility returns EX_DATAERR if errors were found in the group file, and EX_OK otherwise. so like, errors = EX_DATAERR, no errors = EX_OK. simple as that, no cap ✨

---

🔥 DIAGNOSTICS 🔥

for each error she finds, chkgrp will print an error message containing the name of the file being scanned and the line number on which the error was found. so you get, like, receipts. exact coordinates. she's not gonna make you guess where the mess is 💅

---

🌸 SEE ALSO 🌸

• getgrent(3)
• group(5)
• groups(7)

---

⭐ HISTORY ⭐

the chkgrp utility appeared in FreeBSD 3.0. vintage. iconic. she's been doing this since before it was cool 🕰️

---

💖 AUTHORS 💖

the chkgrp utility and this manual page were written by Dag-Erling Smørgrav <des@FreeBSD.org>. further functionality was added by Liam J. Foy <liamfoy@dragonflybsd.org>. legends, both of them, fr fr 🫶

---

🙈 BUGS 🙈

should check the range of the group ID. like, it checks that it's numeric but not that it's reasonable, and honestly? same girl, same 😭

---

lowkey important reminder: she checks syntax, she doesn't fix anything. she's a critic, not a surgeon. don't @ her 💀

---

and that's the page, bestie!! this one came out of the Debian crew, dated April 19, 2026, filed under CHKGRP(8) in your trusty System Manager's Manual — go forth and let your group file be syntactically flawless, periodt 💜✨