Following the recent performance improvement lib/libc/gen/getgrouplist.c 1.13
i had a closer look at YP group support in 4.4-beta. I suggest to explicitely state in the manual which YP maps are required for proper YP group support. Arguably, this is implementation dependent, and on OpenBSD, all standard maps are built by default. On the other hand, the use of YP is common in multi-OS settings, and i think the following information can really come in handy. Besides, group(5) already talks about one particular YP map, not mentioning that two others are needed as well. This might confuse people. Index: lib/libc/gen/getgrent.3 =================================================================== RCS file: /cvs/src/lib/libc/gen/getgrent.3,v retrieving revision 1.14 diff -u -p -r1.14 getgrent.3 --- lib/libc/gen/getgrent.3 31 May 2007 19:19:28 -0000 1.14 +++ lib/libc/gen/getgrent.3 26 Jul 2008 21:02:57 -0000 @@ -144,6 +144,19 @@ characters in size. .\" .Dv _SC_GETGR_R_SIZE_MAX .\" .Xr sysconf 2 .\" parameter. +.Sh YP SUPPORT +If YP is active, the functions +.Fn getgrent +and +.Fn getgrnam +also use the +.Pa group.byname +YP map and the function +.Fn getgrgid +also uses the +.Pa group.bygid +YP map in addition to the group file, +respecting the order of normal and YP entries in the group file. .Sh RETURN VALUES The functions .Fn getgrent , @@ -175,7 +188,9 @@ group database file .El .Sh SEE ALSO .Xr getpwent 3 , -.Xr group 5 +.Xr group 5 , +.Xr yp 8 , +.Xr ypclnt 3 .Sh HISTORY The functions .Fn endgrent , Index: lib/libc/gen/getgrouplist.3 =================================================================== RCS file: /cvs/src/lib/libc/gen/getgrouplist.3,v retrieving revision 1.10 diff -u -p -r1.10 getgrouplist.3 --- lib/libc/gen/getgrouplist.3 31 May 2007 19:19:28 -0000 1.10 +++ lib/libc/gen/getgrouplist.3 26 Jul 2008 21:02:57 -0000 @@ -48,6 +48,9 @@ The is automatically included in the groups list. Typically this value is given as the group number from the password file. +If YP is active, the +.Pa netid.byname +YP map will be used in addition to the group file. .Pp The resulting group list is returned in the integer array pointed to by .Fa groups . @@ -69,8 +72,11 @@ Here, the group array will be filled wit group database file .El .Sh SEE ALSO +.Xr group 5 , .Xr setgroups 2 , -.Xr initgroups 3 +.Xr initgroups 3 , +.Xr yp 8 , +.Xr yp_match 5 .Sh HISTORY The .Fn getgrouplist Index: share/man/man5/group.5 =================================================================== RCS file: /cvs/src/share/man/man5/group.5,v retrieving revision 1.11 diff -u -p -r1.11 group.5 --- share/man/man5/group.5 31 May 2007 19:19:58 -0000 1.11 +++ share/man/man5/group.5 26 Jul 2008 21:02:57 -0000 @@ -118,6 +118,18 @@ form should be on the last line, for his Only the first group with a specific name encountered, whether in the .Nm file itself, or included via YP, will be used. +.Pp +Proper YP group support requires consistent +.Pa group.byname , +.Pa group.bygid +and +.Pa netid.byname +YP maps. +See +.Xr getgrent 3 +and +.Xr getgrouplist 3 +for details. .Sh FILES .Bl -tag -width /etc/group -compact .It Pa /etc/group
