pxfwrite(3F)

NAME
     PXFWRITE - Write a file

SYNOPSIS
     SUBROUTINE PXFWRITE (ifildes, buf, nbyte, nwritten, ierror)
     INTEGER ifildes, nbyte, nwritten, ierror
     CHARACTER BUF(*)

DESCRIPTION
     PXFWRITE uses the write() function to write nbytes to a file associated
     with ifildes from a buffer, return the actual number of bytes written,
     and return the error status.

     The following are valid arguments for this routine:

     ifildes   Default integer input variable containing a file descriptor.

     buf       output character variable containing the data to be written.

     nbyte     Default input integer variable specifying the number of bytes
               to be written.

     nwritten  Default output integer variable containing the number of bytes
               actually written.

     ierror    Default integer output variable that contains zero if the
               operation was successful or nonzero if the operation was not
               successful.

     PXFWRITE may return one of the following error values:

     EAGAIN      Mandatory file and record locking was set, O_NDELAY was set,
                 and there was a blocking record lock.

     EBADF       If ifildes is not a valid file descriptor open for writing.

     EDEADLK     If the write was going to go to sleep and would cause a
                 deadlock situation to occur.

     EFAULT      If buf points outside the allocated process address space.

     EFBIG       If an attempt was made to write a file that exceeds the file
                 size limit or the maximum file size of the process.

     EINTR       If write was interrupted by a signal.

     EINVAL      If the call contains an argument that is not valid.

     ENOLCK      If the sytem record lock table was full, the write could not
                 go to sleep until the block record lock was removed.
     ENOMEM      If PXFWRITE is unable to obtain memory to create an internal
                 buffer.

     ENOSPC      If there is no free space on the device containing the file.

     EPIPE       If attempting to write to a pipe that is not open for reading
                 by any process.

     On IRIX systems, PXFWRITE may also return:

     EIO  If a physical I/O error has occurred, or the read is cannot access
          the device or if ifildes has O_DIRECT or FDIRECT set and nbytes is
          greater than the number of bytes between the current file pointer
          position and the end of file.

     ENOSR
          If there is no free space for the STREAMS memory resources.

     ENOXIO
          If the file pointer is out of range for a special file.

     ERANGE
          If an attempt is made to write toa stream with nbyte outside the
          mininum and maximun write range when the mininum value is nonzero.

     ETIMEDOUT
          If the object of the write is located on a remote system which is
          not available.

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

SEE ALSO
     write(2)