pxfgetpwnam(3F)

NAME
     PXFGETPWNAM - Gets password information about login name

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

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

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

     ENOENT       If an entry matching the login name in name 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 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)

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