Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (g - h) getpwent_r(3)
NAME
getpwent_r - Gets user attribute information from the user database (reentrant)
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series and J-series native Guardian processes that do not use Standard POSIX Threads:
$SYSTEM.ZDLLnnn.ZSECDLL
32-bit H-series and J-series OSS processes that do not use Standard POSIX Threads: |
/G/system/zdllnnn/zsecdll |
64-bit H-series and J-series OSS processes that do not use Standard POSIX Threads: |
/G/system/zdllnnn/ysecdll |
H-series and J-series OSS processes that use the Standard POSIX Threads Library:
/G/system/zdllnnn/zsptdll
(See NOTES)
SYNOPSIS
Synopsis for getpwent_r( ) in H06.21 and later H-series RVUs and J06.10 and later J-series
RVUs (not using the Standard POSIX Threads Library):
#include <pwd.h>
int *getpwent_r (
struct passwd *pwd,
char *buffer,
size_t buflen
struct passwd **result);
Synopsis for getpwent_r( ) in the Standard POSIX Threads Library:
#include <pwd.h>
#include <spthread.h>
struct passwd *getpwent_r (
struct passwd *ret,
char *buffer,
size_t buflen);
PARAMETERS
pwd (getpwent_r( ) in H06.21 and later H-series and J06.10 and later J-series RVUs
only) Contains the updated user information.
ret (Standard POSIX Threads Library version of getpwent_r( ) only) Points to a
passwd structure allocated by the caller.
buffer Points to the buffer supplied by the caller and used as a storage space for
returned data.
buflen Specifies the size of the buffer passed in bytes.
result (getpwent_r( ) in H06.21 and later H-series and J06.10 and later J-series RVUs
only) Points to the address of a passwd structure assigned by the function.
DESCRIPTION
The getpwent_r( ) function is the reentrant version of the getpwent( ) function.
The getpwent_r( ) function returns information about the next user in the user authentication
database. The first call to the getpwent_r( ) function returns information about the first user in
the database. Each subsequent call to getpwent_r( ) returns information for the next user entry,
unless an intervening call to the setpwent( ) function has reset the entry pointer to the beginning
of the database.
527187-017 Hewlett-Packard Company 3−119