Open System Services System Calls Reference Manual (G06.28+)

getgrent_r(2) OSS System Calls Reference Manual
The gr_passwd field is provided for compatibility with some versions of UNIX, but it always
contains a null string.
NOTES
The functions getgrnam_r() and getgrgid_r() should be used instead of this function, to ensure
portability to future systems.
RETURN VALUES
The getgrent_r() function returns a pointer to a struct group if it successfully enumerates an
entry; otherwise, it returns a null pointer and sets errno to indicate the specific error. When the
pointer returned by the function is nonnull, it is always equal to the grp pointer that was supplied
by the caller.
ERRORS
If any of the following conditions occurs, the getgrent_r() function sets errno to the
corresponding value:
[EAGAIN] The system was unable to allocate sufficient user heap space to complete the
requested operation. Any list of usernames returned by the call might be trun-
cated. The call should be reissued to obtain correct data.
[EIO] A disk process or file system input/output error occurred. Data might have been
lost during the transfer.
[EMFILE] The system limit for open file descriptors per process has already reached the
maximum permitted.
[ENOENT] No more group records exist to be returned.
[ENOMEM] The system was unable to allocate sufficient memory for a control block.
[ERANGE] Insufficient storage was supplied via buffer and buflen to contain the data to be
referenced by the resulting group structure.
[EWRONGID] The processor for the disk process that provides access to the database failed
during the input operation and takeover by the backup process occurred. The
operation can be tried again.
RELATED INFORMATION
Functions: endgrent(3), getgrent(3), getgrgid(3), getgrgid_r(2), getgrnam(3), getgrnam_r(2),
setgrent(3).
STANDARDS CONFORMANCE
This function is an extension to the UNIX98 specification. Interfaces documented on this refer-
ence page conform to the following industry standards:
• IEEE Std 1003.1c-1995, POSIX System Application Program Interface
The use of the header file spthread.h is an HP exception to the POSIX standard.
3−48 Hewlett-Packard Company 527186-005