Technical Reference: Base Operating System and Extensions, Volume 1

getpw Subroutine

Purpose

Retrieves a user's /etc/passwd file entry.

Library

Standard C Library (libc.a)

Syntax

int getpw (UserID, Buffer)

uid_t UserID
char *Buffer

Description

The getpw subroutine opens the /etc/passwd file and returns, in the Buffer parameter, the /etc/passwd file entry of the user specified by the UserID parameter.

Parameters

Buffer	Specifies a character buffer large enough to hold any /etc/passwd entry.
UserID	Specifies the ID of the user for which the entry is desired.

Return Values

The getpw subroutine returns:

0	Successful completion
-1	Not successful.

Implementation Specifics

This subroutine is part of AIX Base Operating System (BOS) Runtime.