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)