getpw

Purpose

     Gets a password file entry, given the user ID.

Library

     Standard C Library (libc.a)

Syntax

     int getpw (uid, buf)
     int uid;
     char *buf;

Description

     The getpw  subroutine is included only  for compatibility
     with prior  systems and  should not  be used  unless your
     program is  going to  be used with  a prior  system.  See
     "getpwent,  getpwuid, getpwnam,  setpwent, endpwent"  and
     "putpwent" for subroutines to use instead.

     The getpw searches the password file for a user ID number
     that matches the  uid parameter.  When a  match is found,
     getpw copies the  line of the password file  in which the
     match  was found  into an  array  pointed to  by the  buf
     parameter.  The subroutine then returns a value of 0.  If
     a match cannot be found, the subroutine returns a nonzero
     value.

File

     /etc/passwd

Related Information

     In this book:  "passwd."