Page MenuHomeFreeBSD
Differential D54114

groups.7: Standard group names
Needs ReviewPublic
Actions

Authored by tembun_bk.ru on Dec 7 2025, 9:01 PM.
Tags
Referenced Files
F145777544: D54114.diff
Tue, Feb 24, 9:00 AM
Unknown Object (File)
Wed, Feb 4, 6:17 PM
Unknown Object (File)
Tue, Feb 3, 11:12 AM
Unknown Object (File)
Tue, Feb 3, 5:52 AM
Unknown Object (File)
Tue, Feb 3, 3:26 AM
Unknown Object (File)
Tue, Feb 3, 2:44 AM
Unknown Object (File)
Jan 22 2026, 6:06 PM
Unknown Object (File)
Jan 22 2026, 5:10 PM
View All 40 Files
Subscribers
imp

Details

Reviewers
ziaee
des
maxim
Group Reviewers
docs
manpages
Contributor Reviews (src)
Summary

I'm not 100% sure whether every statement and group description is true for FreeBSD and its current state. Please, point out mistakes in my assumptions.

The group list is sorted by GID. All the group names from /usr/src/etc/group are described, except "uucp": honestly, I don't know what it is used for and what to say about it.

PR: 264966
Obtained from: NetBSD

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

tembun_bk.ru created this revision.Dec 7 2025, 9:01 PM
Herald added a subscriber: imp. · View Herald TranscriptDec 7 2025, 9:01 PM
tembun_bk.ru requested review of this revision.Dec 7 2025, 9:01 PM
tembun_bk.ru added inline comments.Dec 7 2025, 9:11 PM
share/man/man7/groups.7
4–5

What should I do with the license? The page was not only imported, but changed for FreeBSD. I also did change some of the original parts.

208

I'm not sure if I'm right about this one.

247

I'm not quite sure about this one too. If I understand correctly, it must be somehow related to group "uucp" (which is missed), since on my machine /dev/cuau2 is owned by used "uucp" and in group "dialer".

253

I'm not sure if it's really unused now. Didn't find much about it in /usr/src.

265

As above.

269

Didn't have any experience with it, just tried to deduce what it is used for :)

301

That's only my guess described here. Maybe there is a different reason why there are "nogroup" and "nobody".

tembun_bk.ru updated this revision to Diff 167684.Dec 8 2025, 8:19 AM
tembun_bk.ru marked an inline comment as not done.

'December' instead of 'Dec'.

tembun_bk.ru mentioned this in D54154: groups.7: Cross-reference in other man pages.Dec 9 2025, 4:41 PM
ziaee added a child revision: D54154: groups.7: Cross-reference in other man pages.Dec 9 2025, 5:19 PM
tembun_bk.ru updated this revision to Diff 167786.Dec 9 2025, 6:06 PM

Add groups(7) cross-references into other man pages.

tembun_bk.ru added a comment.Dec 18 2025, 9:03 AM

I'm also going to port users(7) man page. The structure and the overall idea of these two pages are very similar; do you have some notes/advises that I can learn from this page and apply to users(7)?

tembun_bk.ru added a comment.Jan 3 2026, 9:51 AM

@ziaee I've been thinking: maybe it would be a nice idea to create hard links for this manual page: wheel.7 and operator.7? wheel and operator are the most noticeable groups and people frequently have questions about their purpose, so it would be nice to be able to do man wheel or man operator. We have the similar thing for builtin.1 which has a link to every builtin command: https://cgit.freebsd.org/src/tree/share/man/man1/Makefile?id=4b0d5d1d6a7c9773e38882feb4747a76b37a645c#n13

ziaee added a comment.Jan 3 2026, 4:33 PM

Sorry I haven't had time to review this yet!

I don't know about adding mlinks. We can't really do it consistently without creating a lot of collision in the apropos database, which is hard for beginners to navigate.

share/man/man7/groups.7
4–5

The license always stays, that's what the first clause therein says (lines 9 and 10), but add a SPDX tag at the top so we can index it mechanically.

tembun_bk.ru added inline comments.Jan 3 2026, 5:15 PM
share/man/man7/groups.7
4–5

That should be 'SPDX-License-Identifier: BSD-2-Clause', right?

imp added inline comments.Jan 3 2026, 5:32 PM
share/man/man7/groups.7
4–5

Yes. I believe this is the standard BSD-2-Clause, or close enough, that this is the right thing.

tembun_bk.ru updated this revision to Diff 168962.Jan 3 2026, 5:55 PM

Add SPDX-License-Identifier.

tembun_bk.ru marked 2 inline comments as done.Jan 3 2026, 5:55 PM
tembun_bk.ru added a comment.Jan 3 2026, 6:04 PM
In D54114#1244827, @ziaee wrote:

Sorry I haven't had time to review this yet!

I don't know about adding mlinks. We can't really do it consistently without creating a lot of collision in the apropos database, which is hard for beginners to navigate.

@imp (sorry, I'm not sure if you can answer this, but since you've been active on this revision) do you think that adding mlinks would be worth it or it is better to avoid such hard links?

tembun_bk.ru updated this revision to Diff 168970.Jan 3 2026, 7:25 PM

Update diff with -U9999.

tembun_bk.ru added a comment.Thu, Jan 29, 8:50 AM

Ping.

tembun_bk.ru added a reviewer: Contributor Reviews (src).Wed, Feb 4, 6:19 PM
tembun_bk.ru added a project: docs.
tembun_bk.ru updated this revision to Diff 171173.Wed, Feb 4, 7:20 PM
  • Document that games group is used by hgame(4) (since b6cad334e64).
  • Correct several mandoc -T lint warnings.
  • Document that bind(8) was removed from the base in FreeBSD 10.0.
  • Replace reference to unbound(8) with local-unbound(8).
  • Remove references to setuid(7), since NetBSD has this page, but FreeBSD does not.
tembun_bk.ru updated this revision to Diff 171328.Fri, Feb 6, 2:21 PM

Add MLINKS: wheel.7 and operator.7.

Revision Contents
Changeset List

PathSize
share/
man/
man5/
3 lines
3 lines
man7/
1 line
344 lines
usr.bin/
id/
5 lines
5 lines
newgrp/
5 lines
usr.sbin/
adduser/
3 lines
chkgrp/
5 lines
chown/
3 lines
3 lines
pw/
3 lines

Diff 171173

View Options

share/man/man5/group.5

Loading...
View Options

share/man/man5/passwd.5

Loading...
View Options

share/man/man7/Makefile

Loading...
View Options

share/man/man7/groups.7

Loading...
View Options

usr.bin/id/groups.1

Loading...
View Options

usr.bin/id/id.1

Loading...
View Options

usr.bin/newgrp/newgrp.1

Loading...
View Options

usr.sbin/adduser/adduser.8

Loading...
View Options

usr.sbin/chkgrp/chkgrp.8

Loading...
View Options

usr.sbin/chown/chgrp.1

Loading...
View Options

usr.sbin/chown/chown.8

Loading...
View Options

usr.sbin/pw/pw.8

Loading...