GETPW(3c,L)                 AIX Technical Reference                 GETPW(3c,L)



-------------------------------------------------------------------------------
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 the
correct subroutines to use.

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."
















Processed November 7, 1990        GETPW(3c,L)                                 1