pxfgetgrnam(3F)

NAME
     PXFGETGRNAM - Gets group information using the group name

SYNOPSIS
     SUBROUTINE PXFGETGRNAM (name, ilen, jgroup, ierror)
     CHARACTER*n name
     INTEGER ilen, jgroup, ierror

IMPLEMENTATION
     UNICOS, UNICOS/mk, and IRIX systems

STANDARDS
     IEEE standard interface for FORTRAN 77

DESCRIPTION
     On IRIX systems, this routine is in libfortran.so which is linked by
     default when compiling programs with the MIPSpro 7 Fortran 90 compiler
     or when compiling programs with the -craylibs option to the MIPSpro
     7.2 F77 compiler.

     The PXFGETGRNAM routine uses the getgrnam(3C) function to obtain group
     information using a group name.

     The following are components of the group structure used by
     PXFGETGRNAM and created by calling PXFSTRUCTCREATE:

     * gr_name: Group name

     * gr_gid:  Group ID

     * gr_nmem: Number of group members contained in gr_mem

     * gr_mem:  Array of group members' login names

     The gr_name component can be accessed by calling PXFSTRGET(3F).
     gr_gid and gr_nmem can be accessed by calling PXFINTGET(3F).
     PXFESTRGET can be used to access the elements of gr_mem.

     When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
     UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
     kind unless documented otherwise.  On UNICOS and UNICOS/mk, default
     kind is KIND=8 for integer, real, complex, and logical arguments; on
     IRIX, the default kind is KIND=4.

     The following is a list of valid arguments for this routine:

     name      An input character character variable or array element
               containing the group name for which group information is
               requested.

     ilen      An input integer variable containing the length of name.  If
               ilen is zero, trailing blanks are stripped.

     jgroup    An output handle of type group created with
               PXFSTRUCTCREATE(3F).

     ierror    An output integer variable that contains zero if group
               information was retrieved or nonzero if PXFGETGRNAM was not
               successful.

     The PXFGETGRNAM routine may also return any of the following error
     values:

     ENOENT    If name contains a non-existant group ID.

     ENOMEM    If memory needed by PXFGETGRNAM could not be allocated.

     EINVAL    If ilen < 0 or ilen > LEN(name).

     EBADHANDLE
               If jgroup is an invalid handle or has an incorrect handle
               type (UNICOS and UNICOS/mk systems only).

EXAMPLES
     In this example, PXFGETGRNAM is called for information about the group
     users.

          program pxftest
          integer jgroup
          integer ierror, igid

          CALL PXFGETGRNAM('users',0,jgroup,ierror)
          CALL PXFINTGET(jgroup,'gr_gid',igid,ierror)
          print *,'group ID for group users is ',igid

          end

SEE ALSO
     PXFINTGET(3F), PXFSTRGET(3F)

     Application Programmer's Library Reference Manual, publication SR-
     2165, for the printed version of this man page.