The branch main has been updated by vangyzen:
URL:
https://cgit.FreeBSD.org/src/commit/?id=9a7c512a614993333beec4e2d509290b0c00dde6
commit 9a7c512a614993333beec4e2d509290b0c00dde6
Author: Eric van Gyzen <vangy...@freebsd.org>
AuthorDate: 2025-08-15 13:16:58 +0000
Commit: Eric van Gyzen <vangy...@freebsd.org>
CommitDate: 2025-08-15 13:29:18 +0000
ucred groups: restore a useful comment
The most useful comments are those that explain _why_.
Restore such an explanation dropped by commit 6d2efbb34fd.
Reviewed by: kevans
Sponsored by: Dell Inc.
Differential Revision: https://reviews.freebsd.org/D51918
---
sys/kern/kern_prot.c | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/sys/kern/kern_prot.c b/sys/kern/kern_prot.c
index dac0e40b0599..0ca42d640767 100644
--- a/sys/kern/kern_prot.c
+++ b/sys/kern/kern_prot.c
@@ -2921,7 +2921,8 @@ crextend(struct ucred *cr, int n)
* Normalizes a set of groups to be applied to a 'struct ucred'.
*
* Normalization ensures that the supplementary groups are sorted in ascending
- * order and do not contain duplicates.
+ * order and do not contain duplicates. This allows group_is_supplementary
+ * to do a binary search.
*/
static void
groups_normalize(int *ngrp, gid_t *groups)
