[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, 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.

Related Information


[ Previous | Next | Contents | Glossary | Home | Search ]