pxffileno(3F)

PXFFILENO - Returns the file descriptor for a specified unit

As shipped in IRIX 6.5.7. Last changed in IRIX 6.5.5.

NAME
     PXFFILENO - Returns the file descriptor for a specified unit

SYNOPSIS
     INTEGER IUNIT, IFILDES, IERROR

     CALL PXFFILENO (iunit, ifildes, ierror)

IMPLEMENTATION
     UNICOS, UNICOS/mk, and IRIX systems

DESCRIPTION
     This routine is supported on IRIX systems for programs compiled using
     the MIPSpro 7 Fortran 90 compiler or compiled with the -craylibs
     option to the MIPSpro F77 compiler.

     The PXFFILENO() subroutine returns in the ifildes argument the file
     descriptor to which the unit identified by iunit is connected.

     Processing of some Fortran file types includes library buffering or
     the addition of control words to the data written.  Users should be
     aware of this when attempting to make use of the file descriptor
     associated with a Fortran unit.  Some Fortran units may not be
     connected to a file descriptor.  For example, a file assigned the
     attributes -F mr.scr.novfl is not connected to a file descriptor.

     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 arguments to PXFFILENO:

     iunit     An input integer variable that contains the Fortran unit
               number.

     ifildes   An output integer variable containing the file descriptor of
               the file identified by iunit.

     ierror    An output integer variable containing the status.

RETURN VALUES
     Upon successful completion of PXFFILENO(), ierror is set to 0.  If any
     of the following conditions occur, ierror is set to the corresponding
     value:

     EINVAL         iunit is not an open unit

     EBADF          iunit is not connected with a file descriptor

SEE ALSO
     Application Programmer's Library Reference Manual for the printed
     version of this man page.