HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

381

382

383

384

385

386

387

388

389

390

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/!!!intro.3c

________________________________________________________________

___ ___

getpw(3C) getpw(3C)

(TO BE OBSOLETED)

NAME

getpw() - get name from UID

SYNOPSIS

#include <pwd.h>

int getpw(uid_t uid, char *buf);

DESCRIPTION

getpw() searches the password ﬁle for a user ID number that equals uid, copies the line of the password

ﬁle in which uid was found into the array pointed to by buf, and returns 0. getpw() returns non-zero if

uid cannot be found. The line is null-terminated.

This routine is included only for compatibility with prior systems, and should not be used; see getpwent(3C)

for routines to use instead.

APPLICATION USAGE

getpw() is thread-safe. It is not async-cancel-safe. A cancellation point may occur when a thread is exe-

cuting getpw().

NETWORKING FEATURES

NFS

This routine is implemented using getpwuid() (see getpwent(3C)) and therefore uses the Network

Information Service network database as described in passwd(4).

RETURN VALUE

getpw() returns non-zero on error.

WARNINGS

The above routine uses <stdio.h>, which causes it to increase, more than might be expected, the size of

programs not otherwise using standard I/O.

Obsolescent Interfaces

getpw() is to be obsoleted at a future date.

AUTHOR

getpw() was developed by AT&T and HP.

FILES

/etc/passwd