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

OSS Library Calls (g - h) getpwent_r(3)
If you are NOT using the Standard POSIX Threads Library (this is not a threaded application or
you are using the POSIX User Thread Model Library), you must:
• Include the pwd.h header file
To use the Standard POSIX Threads library, you must:
• Include the spthread.h header file
• Link your application to the Standard POSIX Threads Library:
/G/system/sysnn/zsptsrl (G-series)
or
/G/system/zdllnnn/zsptdll (H-series or J-series)
• Compile your application using the #define _SPT_MODEL_ macro or an equivalent
compiler command option
For more information about threaded and 64-bit applications in the OSS environment, see the |
Open System Services Programmer’s Guide.
The functions setpwent( ), getpwent( ), and endpwent( ) are used to enumerate password entries
from the database. The setpwent( ) function sets (or resets) the enumeration to the beginning of
the set of password entries. The setpwent( ) function should be called before the first call to
getpwent( ). Successive calls to getpwent( ) return either successive entries or NULL (which
indicates the end of the enumeration). Interleaving calls to re-entrant functions and their
corresponding non re-entrant counterparts leave the enumeration in an undetermined state.
RETURN VALUES
H06.21 and later H-series RVUs and J06.10 and later J-series RVUs
Upon successful completion, the getpwent_r( ) function returns 0 (zero). Otherwise, the
getpwent_r( ) function sets errno to indicate the specific error.
Standard POSIX Threads Library version of getpwent_r( )
Upon successful completion, the getpwent_r( ) function returns a pointer to a valid passwd
structure. Otherwise, the function returns a null pointer and sets errno to indicate the specific
error.
ERRORS
If any of these conditions occur, the getpwent_r( ) function sets errno to the corresponding
value:
[EAGAIN] A system resource is temporarily unavailable. The function cannot allocate
sufficient heap space to complete the call.
[EIO] A disk process or file system input or output error occurred. Data might have
been lost during the transfer.
[ENOCRE] The calling process does not use the Common Run-Time Environment (CRE)
but requested a service that requires CRE (the static area cannot be allocated in
the calling process).
[ENOENT] No more user authentication records exist in the database. (There is no next user
in the database.)
[ENOMEM] There is insufficient user memory to complete the call.
527187-017 Hewlett-Packard Company 3−121