POSIX Subroutine: Gets group information for the named group.
Module: USE IFPOSIX
Syntax
CALL PXFGETGRNAM (name, ilen, jgroup, ierror)
name
(Input) Character. The name of the group to retrieve information about.
ilen
(Input) INTEGER(4). The length of the name string.
jgroup
(Input) INTEGER(4). A handle of structure group
.
ierror
(Output) INTEGER(4). The error status.
If successful, ierror is not changed; otherwise, an error code.
The PXFGETGRNAM subroutine stores the group information from /etc/group
for the entry that matches the group name name in the structure associated with handle jgroup.
To get a handle for an instance of the group
structure, use PXFSTRUCTCREATE with the string 'group' for the structure name.
See Also