Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

PXFGETGRNAM

POSIX Subroutine: Gets group information for the named group. This routine is only available for Linux.

Module

USE IFPOSIX

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.

NOTE:

To get a handle for an instance of the group structure, use PXFSTRUCTCREATE with the string 'group' for the structure name.

See Also