diff options
author | wollman <wollman@FreeBSD.org> | 1994-09-20 22:02:20 +0000 |
---|---|---|
committer | wollman <wollman@FreeBSD.org> | 1994-09-20 22:02:20 +0000 |
commit | 1a7a5b21881ee151dc4442d48489c7c47489e1fd (patch) | |
tree | 7a7c468a1a658253f2f1a46c514a3b30957a9727 /lib/libc/gen/getgrent.3 | |
parent | ebfe3ce6c7cdd09c8e7bb32be6c46ea604b240db (diff) | |
download | FreeBSD-src-1a7a5b21881ee151dc4442d48489c7c47489e1fd.zip FreeBSD-src-1a7a5b21881ee151dc4442d48489c7c47489e1fd.tar.gz |
Document YP support.
Diffstat (limited to 'lib/libc/gen/getgrent.3')
-rw-r--r-- | lib/libc/gen/getgrent.3 | 36 |
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. |