pxfgetgrgid(3F)

NAME
     PXFGETGRGID - Gets group information using the group ID

SYNOPSIS
     SUBROUTINE PXFGETGRGID (igid, jgroup, ierror)

     INTEGER igid, 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
     F77 compiler.

     The PXFGETGRGID routine uses the getgrgid(3C) function to obtain group
     information using a group ID.

     The following are components of the group structure used by
     PXFGETGRGID 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:

     igid      An input integer variable containing the group ID, for which
               group information is requested.

     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 PXFGETGRGID was not
               successful.

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

     ENOENT    If igid contains an non-existant group ID.

     ENOMEM    If memory needed by PXFGETGRGID could not be allocated.

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

EXAMPLES
     In this example, PXFGETGRGID is called for information about the group
     with ID = 0.

          program pxftest
          integer jgroup
          integer ierror,ilen
          character*16 name

          CALL PXFGETGRGID(0,jgroup,ierror)
          CALL PXFSTRGET(jgroup,'gr_name',name,ilen,ierror)
          print *,'group name for the group with ID=0 is ',name

          end

SEE ALSO
     Application Programmer's Library Reference Manual for the printed
     version of this man page.