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

Guardian Native C Library Calls (g - i) getpwent(3)
Use From the Guardian Environment
The getpwent() function can be used by a Guardian process when the process has been compiled
using the #define _XOPEN_SOURCE_EXTENDED 1 feature-test macro or an equivalent com-
piler command option.
NOTES
All information generated by the getpwent() function is stored in a thread-specific area and is
overwritten on subsequent calls to the getpwent(), getpwnam(),orgetpwuid() function. If the
data must be reused, each string should be separately copied before any other function that uses
the thread-specific area is called.
To check for an error resulting from a call to getpwent(), set errno to 0 (zero) before the call.
RETURN VALUES
Upon successful completion, the getpwent() function returns a pointer to a valid passwd struc-
ture. Otherwise, the function returns a null pointer and sets errno to indicate the specific error.
ERRORS
If any of the following conditions occurs, the getpwent() function sets errno to the correspond-
ing 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.
RELATED INFORMATION
Functions: endpwent(3), getpwnam(3), getpwuid(3), setpwent(3).
STANDARDS CONFORMANCE
The HP implementation of this function does not return the errno values [EMFILE] or
[ENFILE].
The following are HP extensions to the XPG4 Version 2 specification:
• The errno values [EAGAIN], [ENOCRE], [ENOENT], and [ENOMEM] can be
returned.
527192-018 Hewlett-Packard Company 3−49