document which functions use which YP maps; Ingo Schwarze

2 files changed, 27 insertions, 6 deletions

diff --git a/lib/libc/gen/getgrent.3 b/lib/libc/gen/getgrent.3
index e6dda40b854..f89a89b0d57 100644
--- a/lib/libc/gen/getgrent.3
+++ b/lib/libc/gen/getgrent.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: getgrent.3,v 1.14 2007/05/31 19:19:28 jmc Exp $
+.\"	$OpenBSD: getgrent.3,v 1.15 2008/07/28 16:27:39 deraadt Exp $
 .\"
 .\" Copyright (c) 1989, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: July 28 2008 $
 .Dt GETGRENT 3
 .Os
 .Sh NAME
@@ -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 ,
diff --git a/lib/libc/gen/getgrouplist.3 b/lib/libc/gen/getgrouplist.3
index 5a8b2f922fd..df5d82b090d 100644
--- a/lib/libc/gen/getgrouplist.3
+++ b/lib/libc/gen/getgrouplist.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: getgrouplist.3,v 1.10 2007/05/31 19:19:28 jmc Exp $
+.\"	$OpenBSD: getgrouplist.3,v 1.11 2008/07/28 16:27:39 deraadt Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: July 28 2008 $
 .Dt GETGROUPLIST 3
 .Os
 .Sh NAME
@@ -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 with as many groups as will fit.
 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