PXFGETPWNAM(3F) Last changed: 1-6-98
NAMEPXFGETPWNAM - 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
7.2 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 ALSOgetpwnam(3C), PXFSTRUCTCREATE(3F), PXFSTRUCTFREE(3F)
Application Programmer's Library Reference Manual, publication SR-
2165, for the printed version of this man page.
