getpw(3)                   DG/UX 4.30                    getpw(3)



     NAME
          getpw - get name from UID

     SYNOPSIS
          int getpw (uid, buf)
          int 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.

     FILES
          /etc/passwd

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

     DIAGNOSTICS
          Getpw returns non-zero on error.

     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)         Page 1