getpw(3C)                      DG/UX R4.11MU05                     getpw(3C)


NAME
       getpw - get name from UID

SYNOPSIS
       #include <stdio.h>
       int getpw (uidt uid, char *buf);

DESCRIPTION
       getpw goes through three steps:

       1.  Search the password file for a user id number that equals uid.

       2.  Copy the line of the password file in which uid was found into
           the array pointed to by buf.

       3.  Return 0.

       getpw returns non-zero if uid cannot be found.

       Do not use this routine in new programs; it is included only for
       compatibility with prior systems. See getpwent(3C) for routines to
       use instead.


   Considerations for Threads Programming
                     +---------+-----------------------------+
                     |         |                      async- |
                     |function | reentrant   cancel   cancel |
                     |         |             point     safe  |
                     +---------+-----------------------------+
                     |getpw    |     Y         Y        N    |
                     +---------+-----------------------------+

FILES
       /etc/passwd

DIAGNOSTICS
       getpw returns non-zero on error.

SEE ALSO
       reentrant(3), getpwent(3C)
       passwd(4).

WARNING
       The above routine uses <stdio.h>, which causes it to increase the
       size of programs that don't otherwise use standard I/O.


Licensed material--property of copyright holder(s)