getpw(3)                            CLIX                            getpw(3)



  NAME

    getpw - Gets a user name from a user ID

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    int getpw(
      int uid ,
      char *buf );

  PARAMETERS

    uid   Specifies a user ID number

    buf   Upon return, contains a line from the password file

  DESCRIPTION

    The getpw function searches the password file 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.  The getpw function
    returns nonzero if uid cannot be found.

    This function is included only for compatibility with prior systems and
    should not be used; see getpwent() for functions to use instead.

  FILES

    /etc/passwd

  CAUTIONS

    The above function uses <stdio.h>, which causes it to increase, more than
    might be expected, the size of programs not otherwise using standard I/O.

  RETURN VALUES

    The command getpw returns nonzero on error.

  RELATED INFORMATION

    Functions: getpwent(3)

    Files: passwd(4)






  2/94 - Intergraph Corporation                                              1