d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document YP support.

Browse Source
This commit is contained in:
Garrett Wollman 1994-09-20 22:02:20 +00:00
parent 9486c394b4
commit 6af9798fed
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=2937
2 changed files with 51 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
lib/libc/gen/getgrent.3
View File

@ -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.

44
lib/libc/gen/getpwent.3
View File

@ -29,9 +29,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" @(#)getpwent.3 8.2 (Berkeley) 12/11/93
.\" From: @(#)getpwent.3 8.2 (Berkeley) 12/11/93
.\"
.Dd December 11, 1993
.Dd September 20, 1994
.Dt GETPWENT 3
.Os
.Sh NAME
@ -133,6 +133,24 @@ If the process which calls them has an effective uid of 0, the encrypted
password will be returned, otherwise, the password field of the returned
structure will point to the string
.Ql * .
.Sh YP/NIS INTERACTION
When the
.Xr yp 4
password database is enabled, the
.Fn getpwnam
and
.Fn getpwuid
functions use the YP maps
.Dq Li passwd.byname
and
.Dq Li passwd.byuid ,
respectively, if the requested password entry is not found in the
local database. The
.Fn getpwent
function will step through the YP map
.Dq Li passwd.byname
if the entire map is enabled as described in
.Xr passwd 5 .
.Sh RETURN VALUES
The functions
.Fn getpwent ,
@ -166,7 +184,8 @@ A Version 7 format password file
.Xr getgrent 3 ,
.Xr passwd 5 ,
.Xr pwd_mkdb 8 ,
.Xr vipw 8
.Xr vipw 8 ,
.Xr yp 4
.Sh HISTORY
The
.Nm getpwent ,
@ -181,6 +200,11 @@ The
.Nm setpassent
function appeared in
.Bx 4.3 Reno .
.Sh COMPATIBILITY
The historic function
.Xr setpwfile 3 ,
which allowed the specification of alternate password databases,
has been deprecated and is no longer available.
.Sh BUGS
The functions
.Fn getpwent ,
@ -191,17 +215,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 routines
.Fn getpwent ,
.Fn endpwent ,
.Fn setpassent ,
and
.Fn setpwent
are fairly useless in a networked environment and should be
avoided, if possible.
.Sh COMPATIBILITY
The historic function
.Xr setpwfile 3 ,
which allowed the specification of alternate password databases,
has been deprecated and is no longer available.