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

Guardian Native C Library Calls (g - i) getgrnam_r(3)

RETURN VALUES

Upon successful completion, the getgrnam_r() function returns 0 (zero). Otherwise, the func-

tion returns an error number, as described in the ERRORS subsection of this reference page.

ERRORS

If any of these conditions occur, the getgrnam_r() function returns the corresponding value:

[EAGAIN] A system resource is temporarily unavailable. The function cannot allocate

sufﬁcient heap space to complete the call.

[EINVAL] The value speciﬁed for the name parameter contains invalid characters or cannot

be passed in the call for other reasons.

[EIO] A disk process or ﬁle system input or output error occurred. Data might have

been lost during the transfer.

[ENAMETOOLONG]

The value speciﬁed for the name parameter exceeds the maximum number of

characters allowed for a group name.

[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] The speciﬁed group name does not exist, or the name parameter points to an

empty string.

[ENOMEM] There is insufﬁcient user memory to complete the call.

[ERANGE] Insufﬁcient storage was supplied via buffer and buﬂen to contain the data to be

referenced by the resulting group structure.

RELATED INFORMATION

Functions: getgrgid(3), getgrgid_r(3), getgrnam(3), getpwent(3), getpwent_r(3).

STANDARDS CONFORMANCE

H06.21 and later H-series RVUs, J06.10 and later J-series RVUs

This function conforms to IEEE Std 1003.1 2004, POSIX System Application Program Interface.

Standard POSIX Threads Library

This function is an extension to the UNIX98 speciﬁcation. 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 ﬁle spthread.h is an HP exception to the POSIX standard.

527192-018 Hewlett-Packard Company 3−39