pxfgetpwuid(3F)

NAME
     PXFGETPWUID - Gets password information by using user ID

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

     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 by the UNICOS and IRIX
     operating systems, 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: a comment in the UNICOS operating system; the user's real
       name on IRIX systems.

     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 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 errors:

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

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

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.