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