pxfgetgrgid(3F)

NAME
     PXFGETGRGID - Gets group information using the group ID

SYNOPSIS
     SUBROUTINE PXFGETGRGID (igid, jgroup, ierror)

     INTEGER igid, jgroup, ierror

STANDARDS
     IEEE standard interface for FORTRAN 77

DESCRIPTION
     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.

     All arguments must be of default kind unless documented otherwise.  On
     IRIX systems, 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.

NOTES
     The PXF_DEFINITIONS module can be used by Fortran 90 users to enable
     caller-callee interface checking.

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.