opensolaris man page for getpw

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)

SunOS 5.11							    29 Dec 1996 							 getpw(3C)