pxfgetpwnam(3F)

NAME
     PXFGETPWNAM - Gets password information about login name

SYNOPSIS
     SUBROUTINE PXFGETPWNAM (name, ilen, jpasswd, ierror)
     INTEGER ilen, jpasswd, ierror
     CHARACTER*n

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 PXFGETPWNAM routine uses the getpwnam(3C) function to return
     password information about a login name.  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)

     * pw_comment: comment

     * pw_gecos: the user's real name.

     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.

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

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

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

     The PXFGETPWNAM routine may return the following error:

     ENOENT       If an entry matching the login name in name 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 ilen, ierror, value
          integer*8 jpasswd
          CALL PXFSTRUCTCREATE('passwd',jpasswd,ierror)
          name = 'root'
          ilen = 4
          CALL PXFGETPWNAM(name,ilen,jpasswd,ierror)
          if (ierror .eq. 0) then
             print *,'PASSED: pxfgetpwnam call'
                else
             print *,'FAILED: pxfgetpwnam call with error = ',ierror
          endif
          CALL PXFSTRUCTFREE(jpasswd,ierror)
          end

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