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(5) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Safe |
+---------------+-----------------+

SEE ALSO


getpwnam(3C), passwd(4), attributes(5)


December 29, 1996 GETPW(3C)