pxfctermid(3F)

NAME
     PXFCTERMID - Generates terminal pathname

SYNOPSIS
     SUBROUTINE PXFCTERMID (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 PXFCTERMID subroutine uses the ctermid function to generate a
     string which is the pathname for the current process' controlling
     terminal.  If the pathname for the controlling terminal cannot be
     determined, the ilen variable is set to zero.

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

     s         An output character array or character element variable for
               the pathname for the current process' controlling terminal.
               The maximum length of s is defined by the L_ctermid constant
               found in <stdio.h>.

     ilen      An output interger variable for the length of s.

     ierror    An output integer variable for the completion status of
               PXFCTERMID. ierror may contain zero if PXFCTERMID was
               successful or nonzero if PXFCTERMID was not successful.

     PXFCTERMID may return the ETRUNC error value if the output variable s
     cannot contain the pathname for the current process' controlling
     terminal, causing the pathname to be truncated.

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

EXAMPLES
          program pxftest
          integer ilen, ierror
          character*20 s

          CALL PXFCTERMID(s,ilen,ierror)
          print *,'controlling terminal is ',s
          end

SEE ALSO
     ctermid(3S) on IRIX systems