AWRITEV(2-SVR3)     RISC/os Reference Manual      AWRITEV(2-SVR3)



NAME
     awritev - asynchronous scatter/gather write

SYNOPSIS
     #include <sys/aio.h>

     aiohandlet awritev(int fildes, struct aiorb *aiorbp);


DESCRIPTION
     awritev allows the calling process to write data from
     aiorbp->aiovcnt buffers specified by the members of the
     aiorbp->aio_iov array to the file associated with fildes.
     The function call returns when the write request has been
     initiated or queued to the file or device (even when the
     data cannot be delivered immediately).  If an error condi-
     tion is encountered during queuing, the function call
     returns without having initiated or queued the request.

RETURNS
     awritev returns a handle to the calling process if the func-
     tion is successful, otherwise, the function returns the
     value -1, and sets errno to indicate the error.  The handle
     returned is used for subsequent operations.

ERRORS
     If any of the following conditions occur, awritev returns -1
     and sets errno to the corresponding value:

     [EAGAIN]       The requested asynchronous I/O operation was
                    not queued due to system resource limita-
                    tions.

     [EBADF]        The fildes argument is not a valid file
                    descriptor open for writing.

     [EINVAL]       The aio_whence member is not a proper value,
                    or the resulting file pointer is invalid.

     In the case that awritev successfully queues the I/O opera-
     tions but the operation is subsequently canceled or
     encounters an error, the aio_errno element of the aiocb
     structure contains one of the values normally returned by
     the read system call.  In addition, the following error code
     may be encountered:

     [ECANCEL]      The requested I/O was canceled before the I/O
                    completed due to an explicit acancel request.

SEE ALSO
     acancel(2), aread(2), areadv(2), astatus(2), await(2),
     awrite(2), listio(2), aio(5).



                        Printed 11/19/92                   Page 1