Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

getpwent_r(3) Guardian Native C Library Calls Reference Manual
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.
3−50 Hewlett-Packard Company 527192-018