GETPW(3C) Standard C Library Functions GETPW(3C)
NAME
getpw - get passwd entry from UID
SYNOPSIS
#include <stdlib.h>
int getpw(
uid_t uid,
char *buf);
DESCRIPTION
The
getpw() function searches the user data base for a user id number
that equals
uid, copies the line of the password file in which
uid was
found into the array pointed to by
buf, and returns 0.
getpw() returns
non-zero if
uid cannot be found.
USAGE
This function is included only for compatibility with prior systems and
should not be used; the functions described on the
getpwnam(3C) manual
page should be used instead.
If the
/etc/passwd and the
/etc/group files have a plus sign (
+) for the
NIS entry, then
getpwent() and
getgrent() will not return
NULL when the
end of file is reached. See
getpwnam(3C).
RETURN VALUES
The
getpw() function returns non-zero on error.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Safe |
+---------------+-----------------+
SEE ALSO
getpwnam(3C),
passwd(5),
attributes(7) December 29, 1996
GETPW(3C)