From: Bill Joy <wnj@ucbvax.Berkeley.EDU>
Date: Fri, 23 Nov 1979 10:04:11 +0000 (-0800)
Subject: BSD 3 development
X-Git-Tag: BSD-3~672
X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/commitdiff_plain/e918e941fe118e348f9567b89b38c91278815a05

BSD 3 development
Work on file usr/man/man3/getpwent.3

Synthesized-from: 3bsd
---

diff --git a/usr/man/man3/getpwent.3 b/usr/man/man3/getpwent.3
new file mode 100644
index 0000000000..d0da6d312a
--- /dev/null
+++ b/usr/man/man3/getpwent.3
@@ -0,0 +1,70 @@
+.TH GETPWENT 3 
+.SH NAME
+getpwent, getpwuid, getpwnam, setpwent, endpwent \- get password file entry
+.SH SYNOPSIS
+.B #include <pwd.h>
+.PP
+.B struct passwd *getpwent();
+.PP
+.B struct passwd *getpwuid(uid) int uid;
+.PP
+.B struct passwd *getpwnam(name) char *name;
+.PP
+.B int setpwent();
+.PP
+.B int endpwent();
+.SH DESCRIPTION
+.I Getpwent,
+.I getpwuid
+and
+.I getpwnam
+each return a pointer to an object with the
+following structure
+containing the broken-out
+fields of a line in the password file.
+.RS
+.PP
+.nf
+.so /usr/include/pwd.h
+.ft R
+.ad
+.fi
+.RE
+.PP
+The fields
+.I pw_quota
+and
+.I pw_comment
+are unused; the others have meanings described in
+.IR passwd (5).
+.PP
+.I Getpwent
+reads the next
+line (opening the file if necessary);
+.I setpwent
+rewinds the file;
+.I endpwent
+closes it.
+.PP
+.I Getpwuid
+and
+.I getpwnam
+search from the beginning until a matching
+.I uid
+or
+.I name
+is found
+(or until EOF is encountered).
+.SH FILES
+/etc/passwd
+.SH "SEE ALSO"
+getlogin(3), getgrent(3), passwd(5)
+.SH DIAGNOSTICS
+Null pointer
+(0) returned on EOF or error.
+.SH BUGS
+All information
+is contained in a static area
+so it must be copied if it is
+to be saved.
+.br