define new library function getgrouplist

[unix-history] / usr / src / lib / libc / gen / getgrent.3

diff --git a/usr/src/lib/libc/gen/getgrent.3 b/usr/src/lib/libc/gen/getgrent.3
index 6485b10..9f1c892 100644 (file)
--- a/usr/src/lib/libc/gen/getgrent.3
+++ b/usr/src/lib/libc/gen/getgrent.3
@@ -3,7 +3,7 @@
 .\"
 .\" %sccs.include.redist.man%
 .\"
 .\"
 .\" %sccs.include.redist.man%
 .\"

-.\"     @(#)getgrent.3 6.7 (Berkeley) %G%
+.\"     @(#)getgrent.3 6.8 (Berkeley) %G%

 .\"
 .Dd 
 .Dt GETGRENT 3
 .\"
 .Dd 
 .Dt GETGRENT 3


@@ -13,7 +13,7 @@
 .Nm getgrnam ,
 .Nm getgrgid ,
 .Nm setgroupent ,
 .Nm getgrnam ,
 .Nm getgrgid ,
 .Nm setgroupent ,

-.Nm setgrfile ,
+.\" .Nm setgrfile ,

 .Nm setgrent ,
 .Nm endgrent
 .Nd group database operations
 .Nm setgrent ,
 .Nm endgrent
 .Nd group database operations


@@ -27,8 +27,8 @@
 .Fn getgrgid "gid_t gid"
 .Ft struct group *
 .Fn setgroupent "int stayopen"
 .Fn getgrgid "gid_t gid"
 .Ft struct group *
 .Fn setgroupent "int stayopen"

-.Ft void
-.Fn setgrfile "const char *name"
+.\" .Ft void
+.\" .Fn setgrfile "const char *name"

 .Ft int
 .Fn setgrent void
 .Ft void
 .Ft int
 .Fn setgrent void
 .Ft void


@@ -73,13 +73,6 @@ that wish to step through the complete list of groups.
 All three routines will open the group file for reading, if necesssary.
 .Pp
 The
 All three routines will open the group file for reading, if necesssary.
 .Pp
 The

-.Fn setgrfile
-function
-changes the default group file to
-.Fa file ,
-thus allowing the use of alternate group files.
-.Pp
-The

 .Fn setgroupent
 function
 opens the file, or rewinds it if it is already open.  If
 .Fn setgroupent
 function
 opens the file, or rewinds it if it is already open.  If


@@ -145,6 +138,11 @@ and
 .Fn setgroupent
 appeared in
 .Bx 4.3 Reno .
 .Fn setgroupent
 appeared in
 .Bx 4.3 Reno .

+.Sh COMPATIBILITY
+The historic function
+.Fn setgrfile ,
+which allowed the specification of alternate password databases, has
+been deprecated and is no longer available.

 .Sh BUGS
 The functions
 .Fn getgrent ,
 .Sh BUGS
 The functions
 .Fn getgrent ,