pxfgetlogin(3F)

NAME
     PXFGETLOGIN - Gets user name

SYNOPSIS
     SUBROUTINE PXFGETLOGIN (s, ilen, ierror)
     CHARACTER*n s
     INTEGER ilen, ierror

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 PXFGETLOGIN routine uses the cuserid(3C) function to fill s with
     the user login name associated with the calling process.

     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:

     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.

NOTES
     The PXF_DEFINITIONS module can be used by Fortran 90 users to enable
     caller-callee interface checking.

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 ALSO
     cuserid(3C)