aio_read.2 (68580) | aio_read.2 (79754) |
---|---|
1.\" Copyright (c) 1998 Terry Lambert 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) 1998 Terry Lambert 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_read.2 68580 2000-11-10 20:57:05Z alfred $ | 25.\" $FreeBSD: head/lib/libc/sys/aio_read.2 79754 2001-07-15 07:53:42Z dd $ |
26.\" 27.Dd November 17, 1998 28.Dt AIO_READ 2 29.Os 30.Sh NAME 31.Nm aio_read 32.Nd asynchronous read from a file (REALTIME) 33.Sh LIBRARY --- 9 unchanged lines hidden (view full) --- 43function allows the calling process to read 44.Fa iocb->aio_nbytes 45from the descriptor 46.Fa iocb->aio_fildes 47beginning at the offset 48.Fa iocb->aio_offset 49into the buffer pointed to by 50.Fa iocb->aio_buf . | 26.\" 27.Dd November 17, 1998 28.Dt AIO_READ 2 29.Os 30.Sh NAME 31.Nm aio_read 32.Nd asynchronous read from a file (REALTIME) 33.Sh LIBRARY --- 9 unchanged lines hidden (view full) --- 43function allows the calling process to read 44.Fa iocb->aio_nbytes 45from the descriptor 46.Fa iocb->aio_fildes 47beginning at the offset 48.Fa iocb->aio_offset 49into the buffer pointed to by 50.Fa iocb->aio_buf . |
51The call returns immediately after the read request has | 51The call returns immediately after the read request has |
52been enqueued to the descriptor; the read may or may not have 53completed at the time the call returns. 54.Pp 55If _POSIX_PRIORITIZED_IO is defined, and the descriptor supports it, 56then the enqueued operation is submitted at a priority equal to that 57of the calling process minus 58.Fa iocb->aio_reqprio . 59.Pp --- 25 unchanged lines hidden (view full) --- 85and the buffer that the 86.Fa iocb->aio_buf 87member of that structure references must remain valid until the 88operation has completed. For this reason, use of auto (stack) variables 89for these objects is discouraged. 90.Pp 91The asynchronous I/O control buffer 92.Fa iocb | 52been enqueued to the descriptor; the read may or may not have 53completed at the time the call returns. 54.Pp 55If _POSIX_PRIORITIZED_IO is defined, and the descriptor supports it, 56then the enqueued operation is submitted at a priority equal to that 57of the calling process minus 58.Fa iocb->aio_reqprio . 59.Pp --- 25 unchanged lines hidden (view full) --- 85and the buffer that the 86.Fa iocb->aio_buf 87member of that structure references must remain valid until the 88operation has completed. For this reason, use of auto (stack) variables 89for these objects is discouraged. 90.Pp 91The asynchronous I/O control buffer 92.Fa iocb |
93should be zeroed before the | 93should be zeroed before the |
94.Fn aio_read 95call to avoid passing bogus context information to the kernel. 96.Pp 97Modifications of the Asynchronous I/O Control Block structure or the 98buffer contents after the request has been enqueued, but before the 99request has completed, are not allowed. 100.Pp 101If the file offset in --- 88 unchanged lines hidden (view full) --- 190.Nm 191function first appeared in 192.Fx 3.0 . 193.Sh AUTHORS 194This 195manual page was written by 196.An Terry Lambert Aq terry@whistle.com . 197.Sh BUGS | 94.Fn aio_read 95call to avoid passing bogus context information to the kernel. 96.Pp 97Modifications of the Asynchronous I/O Control Block structure or the 98buffer contents after the request has been enqueued, but before the 99request has completed, are not allowed. 100.Pp 101If the file offset in --- 88 unchanged lines hidden (view full) --- 190.Nm 191function first appeared in 192.Fx 3.0 . 193.Sh AUTHORS 194This 195manual page was written by 196.An Terry Lambert Aq terry@whistle.com . 197.Sh BUGS |
198Invalid information in | 198Invalid information in |
199.Fa iocb->_aiocb_private 200may confuse the kernel. | 199.Fa iocb->_aiocb_private 200may confuse the kernel. |