PXFGETLOGIN(3F) Last changed: 1-6-98
NAME
PXFGETLOGIN - Gets user name
SYNOPSIS
SUBROUTINE PXFGETLOGIN (s, ilen, ierror)
CHARACTER*n s
INTEGER ilen, 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.
The PXFGETLOGIN routine uses the cuserid(3C) function to fill s with
the user login name associated with the calling process.
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:
s An output character variable or array element for the user's
login name.
ilen An output integer variable containing the length of s.
ierror An output integer variable that contains zero if the user's
login name was successfully acquired or nonzero if
PXFGETLOGIN was unsuccessful.
The PXFGETLOGIN routine may return the ETRUNC error value if the
length of s is smaller than the length of the user's login name.
EXAMPLES
In this example, PXFGETLOGIN is called and the returned user login
name is printed.
program pxftest
character*16 s
integer ilen, ierror
c find the user name associated with this process
CALL PXFGETLOGIN(s, ilen, ierror)
print *,'user name = ',s,' length = ',ilen,' error = ',ierror
end
SEE ALSOcuserid(3C)
Application Programmer's Library Reference Manual, publication SR-
2165, for the printed version of this man page.
