man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

getpw(3C)

Name

getpw - get passwd entry from UID

Synopsis

#include <stdlib.h>

int getpw(uid_t uid, char *buf);

Description

The getpw() function searches the user data base 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. getpw() returns non-zero if uid cannot be found.

Usage

This function is included only for compatibility with prior systems and should not be used; the functions described on the getpwnam(3C) manual page should be used instead.

If the /etc/passwd and the /etc/group files have a plus sign (+) for the NIS entry, then getpwent() and getgrent() will not return NULL when the end of file is reached. See getpwnam(3C).

Return Values

The getpw() function returns non-zero on error.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
MT-Level
Safe

See also

getpwnam(3C), passwd(4), attributes(5)