aio_write.2 (109174) | aio_write.2 (131504) |
---|---|
1.\" Copyright (c) 1999 Softweyr LLC. 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" | 1.\" Copyright (c) 1999 Softweyr LLC. 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" |
25.\" $FreeBSD: head/lib/libc/sys/aio_write.2 109174 2003-01-13 10:37:11Z tjr $ | 25.\" $FreeBSD: head/lib/libc/sys/aio_write.2 131504 2004-07-02 23:52:20Z ru $ |
26.\" 27.Dd June 2, 1999 28.Dt AIO_WRITE 2 29.Os 30.Sh NAME 31.Nm aio_write 32.Nd asynchronous write to a file (REALTIME) 33.Sh LIBRARY --- 8 unchanged lines hidden (view full) --- 42system call allows the calling process to write 43.Fa iocb->aio_nbytes 44from the buffer pointed to by 45.Fa iocb->aio_buf 46to the descriptor 47.Fa iocb->aio_fildes . 48The call returns immediately after the write request has been enqueued 49to the descriptor; the write may or may not have completed at the time | 26.\" 27.Dd June 2, 1999 28.Dt AIO_WRITE 2 29.Os 30.Sh NAME 31.Nm aio_write 32.Nd asynchronous write to a file (REALTIME) 33.Sh LIBRARY --- 8 unchanged lines hidden (view full) --- 42system call allows the calling process to write 43.Fa iocb->aio_nbytes 44from the buffer pointed to by 45.Fa iocb->aio_buf 46to the descriptor 47.Fa iocb->aio_fildes . 48The call returns immediately after the write request has been enqueued 49to the descriptor; the write may or may not have completed at the time |
50the call returns. If the request could not be enqueued, generally due | 50the call returns. 51If the request could not be enqueued, generally due |
51to invalid arguments, the call returns without having enqueued the 52request. 53.Pp 54If 55.Dv O_APPEND 56is set for 57.Fa iocb->aio_fildes , 58.Fn aio_write 59operations append to the file in the same order as the calls were | 52to invalid arguments, the call returns without having enqueued the 53request. 54.Pp 55If 56.Dv O_APPEND 57is set for 58.Fa iocb->aio_fildes , 59.Fn aio_write 60operations append to the file in the same order as the calls were |
60made. If | 61made. 62If |
61.Dv O_APPEND 62is not set for the file descriptor, the write operation will occur at 63the absolute position from the beginning of the file plus 64.Fa iocb->aio_offset . 65.Pp 66If 67.Dv _POSIX_PRIORITIZED_IO 68is defined, and the descriptor supports it, then the enqueued --- 15 unchanged lines hidden (view full) --- 84can be modified during the request as context, so this value must not 85be referenced after the request is enqueued. 86.Sh RESTRICTIONS 87The Asynchronous I/O Control Block structure pointed to by 88.Fa iocb 89and the buffer that the 90.Fa iocb->aio_buf 91member of that structure references must remain valid until the | 63.Dv O_APPEND 64is not set for the file descriptor, the write operation will occur at 65the absolute position from the beginning of the file plus 66.Fa iocb->aio_offset . 67.Pp 68If 69.Dv _POSIX_PRIORITIZED_IO 70is defined, and the descriptor supports it, then the enqueued --- 15 unchanged lines hidden (view full) --- 86can be modified during the request as context, so this value must not 87be referenced after the request is enqueued. 88.Sh RESTRICTIONS 89The Asynchronous I/O Control Block structure pointed to by 90.Fa iocb 91and the buffer that the 92.Fa iocb->aio_buf 93member of that structure references must remain valid until the |
92operation has completed. For this reason, use of auto (stack) variables | 94operation has completed. 95For this reason, use of auto (stack) variables |
93for these objects is discouraged. 94.Pp 95The asynchronous I/O control buffer 96.Fa iocb 97should be zeroed before the 98.Fn aio_write 99system call to avoid passing bogus context information to the kernel. 100.Pp --- 18 unchanged lines hidden (view full) --- 119.It Bq Er ENOSYS 120The 121.Fn aio_write 122system call is not supported. 123.El 124.Pp 125The following conditions may be synchronously detected when the 126.Fn aio_write | 96for these objects is discouraged. 97.Pp 98The asynchronous I/O control buffer 99.Fa iocb 100should be zeroed before the 101.Fn aio_write 102system call to avoid passing bogus context information to the kernel. 103.Pp --- 18 unchanged lines hidden (view full) --- 122.It Bq Er ENOSYS 123The 124.Fn aio_write 125system call is not supported. 126.El 127.Pp 128The following conditions may be synchronously detected when the 129.Fn aio_write |
127system call is made, or asynchronously, at any time thereafter. If they | 130system call is made, or asynchronously, at any time thereafter. 131If they |
128are detected at call time, 129.Fn aio_write 130returns -1 and sets 131.Va errno 132appropriately; otherwise the 133.Fn aio_return 134system call must be called, and will return -1, and 135.Fn aio_error --- 70 unchanged lines hidden --- | 132are detected at call time, 133.Fn aio_write 134returns -1 and sets 135.Va errno 136appropriately; otherwise the 137.Fn aio_return 138system call must be called, and will return -1, and 139.Fn aio_error --- 70 unchanged lines hidden --- |