Document YP support.

1 files changed, 24 insertions, 12 deletions

diff --git a/lib/libc/gen/getgrent.3 b/lib/libc/gen/getgrent.3
index e0e2782..132ba6b 100644
--- a/lib/libc/gen/getgrent.3
+++ b/lib/libc/gen/getgrent.3
@@ -29,9 +29,10 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)getgrent.3	8.2 (Berkeley) 4/19/94
+.\"     From: @(#)getgrent.3	8.2 (Berkeley) 4/19/94
+.\"	$Id$
 .\"
-.Dd April 19, 1994
+.Dd September 29, 1994
 .Dt GETGRENT 3
 .Os
 .Sh NAME
@@ -121,6 +122,25 @@ The
 .Fn endgrent
 function
 closes any open files.
+.Sh YP/NIS INTERACTION
+When the
+.Xr yp 4
+group database is enabled, the
+.Fn getgrnam
+and
+.Fn getgrgid
+functions use the YP maps
+.Dq Li group.byname
+and
+.Dq Li group.bygid ,
+respectively, if the requested group is not found in the local
+.Pa /etc/group
+file.  The
+.Fn getgrent
+function will step through the YP map
+.Dq Li group.byname
+if the entire map is enabled as described in
+.Xr group 5 .
 .Sh RETURN VALUES
 The functions
 .Fn getgrent ,
@@ -147,7 +167,8 @@ group database file
 .El
 .Sh SEE ALSO
 .Fn getpwent 3 ,
-.Fn group 5
+.Fn group 5 ,
+.Fn yp 4
 .Sh HISTORY
 The functions
 .Fn endgrent ,
@@ -181,12 +202,3 @@ leave their results in an internal static object and return
 a pointer to that object. Subsequent calls to
 the same function
 will modify the same object.
-.Pp
-The functions
-.Fn getgrent ,
-.Fn endgrent ,
-.Fn setgroupent ,
-and
-.Fn setgrent
-are fairly useless in a networked environment and should be
-avoided, if possible.