[src/netbsd-1-4]: src/lib/libc/gen pullup 1.5->1.6 (lukem)

[perry <perry%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/99145af9158d
branches:  netbsd-1-4
changeset: 468513:99145af9158d
user:      perry <perry%NetBSD.org@localhost>
date:      Tue Apr 27 14:11:21 1999 +0000

description:
pullup 1.5->1.6 (lukem)

diffstat:

 lib/libc/gen/getgrouplist.3 |  18 ++++++++++++++----
 1 files changed, 14 insertions(+), 4 deletions(-)

diffs (56 lines):

diff -r 60a2f2401964 -r 99145af9158d lib/libc/gen/getgrouplist.3
--- a/lib/libc/gen/getgrouplist.3       Tue Apr 27 14:11:10 1999 +0000
+++ b/lib/libc/gen/getgrouplist.3       Tue Apr 27 14:11:21 1999 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getgrouplist.3,v 1.5 1998/02/05 18:46:41 perry Exp $
+.\"    $NetBSD: getgrouplist.3,v 1.5.2.1 1999/04/27 14:11:21 perry Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)getgrouplist.3     8.1 (Berkeley) 6/9/93
 .\"
-.Dd June 9, 1993
+.Dd April 25, 1999
 .Dt GETGROUPLIST 3
 .Os
 .Sh NAME
@@ -48,14 +48,14 @@
 .Sh DESCRIPTION
 The
 .Fn getgrouplist
-function reads through the group file and calculates
+function reads through the group database and calculates
 the group access list for the user specified in
 .Fa name .
 The
 .Fa basegid
 is automatically included in the groups list.
 Typically this value is given as
-the group number from the password file.
+the group number from the password database.
 .Pp
 The resulting group list is returned in the integer array pointed to by
 .Fa groups .
@@ -65,6 +65,8 @@
 .Fa ngroups ;
 the actual number of groups found is returned in
 .Fa ngroups .
+.Pp
+Duplicate group ids will be suppressed from the result.
 .Sh RETURN VALUES
 The
 .Fn getgrouplist
@@ -95,3 +97,11 @@
 the group structure will
 be overwritten in the call to
 .Fn getgrouplist .
+.Pp
+In the case where the group array is too small and duplicate gids
+have been suppressed, the returned
+.Fa ngroups
+will be too large by a factor of the difference between the given
+size and the number of matches.
+This is not considered to be a major problem, since it's still going
+to be a smaller figure than when duplicates were not suppressed.