pxfgetpwuid(3F)

NAME
     PXFGETPWUID - Gets password information by using user ID

SYNOPSIS
     SUBROUTINE PXFGETPWUID (name, iuid, jpasswd, ierror)
     INTEGER iuid, jpasswd, 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.

     PXFGETPWUID uses the getpwuid(3C) function to return password
     information about a user ID. It uses the following components of the
     passwd structure:

     * pw_name: login name

     * pw_uid: user ID

     * pw_gid: group ID

     * pw_dir: default login directory

     * pw_shell: default login shell or program

     The following components are supported but are not part of the POSIX
     1003.9-1992 standard.

     * pw_passwd: encrypted password

     * pw_age: password age (character string) (unused on IRIX systems)

     * pw_comment: comment

     * pw_gecos: the user's real name on IRIX systems.

     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:

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

     iuid      An input integer variable containing the user ID for which
               password information is requested.

     jpasswd   An output handle of type passwd created with
               PXFSTRUCTCREATE(3F).

     ierror    An output integer variable that contains zero if PXFGETPWUID
               was successful or nonzero if PXFGETPWUID was not successful.

     The PXFGETPWUID routine may return the following error:

     ENOENT       If an entry matching the user ID in iuid was not found.

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

EXAMPLES
     In this example, the password information will be acquired for the
     login name root.

          program pxftest
          integer iuid, ierror, value
          integer*8 jpasswd

          CALL PXFSTRUCTCREATE('passwd',jpasswd,ierror)
          iuid=0
          CALL PXFGETPWUID(iuid,jpasswd,ierror)
          if (ierror .eq. 0) then
             print *,'PASSED: pxfgetpwuid call'
                else
             print *,'FAILED: pxfgetpwuid call with error = ',ierror
          endif

          CALL PXFSTRUCTFREE(jpasswd,ierror)
          end

SEE ALSO
     getpwnam(3C), PXFSTRUCTCREATE(3F), PXFSTRUCTFREE(3F)

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