NAME    [Toc]    [Back]

     getpw -- get name from uid

LIBRARY    [Toc]    [Back]

     Compatibility Library (libcompat, -lcompat)

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>

     int
     getpw(uid_t uid, char *buf);

DESCRIPTION    [Toc]    [Back]

     The getpw() function is made obsolete by getpwuid(3).

     The getpw() function reads the file /etc/passwd, and if it finds the
     specified uid, copies the password entry line into the string pointed to
     by buf.  the null terminated entry line from the password database, and
     appends the NUL character.

RETURN VALUES    [Toc]    [Back]

     The getpw() function returns the zero if successful, otherwise a non-zero
     if the entry does not exist.

FILES    [Toc]    [Back]

     /etc/passwd

SEE ALSO    [Toc]    [Back]

     getpwent(3), passwd(5)

HISTORY    [Toc]    [Back]

     A getpw() function appeared in Version 6 AT&T UNIX.

BUGS    [Toc]    [Back]

     The area pointed to by buf must be large enough to hold the user name.

     All of the bugs from getpwent(3) hold valid as well.


FreeBSD 5.2.1			 June 4, 1993			 FreeBSD 5.2.1