PXFFILENO(3F) Last changed: 1-6-98
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 7.2 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, publication SR-
2165, for the printed version of this man page.
