aio_read.2 (109217) | aio_read.2 (131504) |
---|---|
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 109217 2003-01-14 02:37:06Z tjr $ | 25.\" $FreeBSD: head/lib/libc/sys/aio_read.2 131504 2004-07-02 23:52:20Z ru $ |
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 --- 46 unchanged lines hidden (view full) --- 80can be modified during the request as context, so this value must 81not be referenced after the request is enqueued. 82.Sh RESTRICTIONS 83The Asynchronous I/O Control Block structure pointed to by 84.Fa iocb 85and the buffer that the 86.Fa iocb->aio_buf 87member of that structure references must remain valid until the | 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 --- 46 unchanged lines hidden (view full) --- 80can be modified during the request as context, so this value must 81not be referenced after the request is enqueued. 82.Sh RESTRICTIONS 83The Asynchronous I/O Control Block structure pointed to by 84.Fa iocb 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 | 88operation has completed. 89For 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 94.Fn aio_read 95call to avoid passing bogus context information to the kernel. 96.Pp --- 20 unchanged lines hidden (view full) --- 117.It Bq Er ENOSYS 118The 119.Fn aio_read 120system call is not supported. 121.El 122.Pp 123The following conditions may be synchronously detected when the 124.Fn aio_read | 90for these objects is discouraged. 91.Pp 92The asynchronous I/O control buffer 93.Fa iocb 94should be zeroed before the 95.Fn aio_read 96call to avoid passing bogus context information to the kernel. 97.Pp --- 20 unchanged lines hidden (view full) --- 118.It Bq Er ENOSYS 119The 120.Fn aio_read 121system call is not supported. 122.El 123.Pp 124The following conditions may be synchronously detected when the 125.Fn aio_read |
125system call is made, or asynchronously, at any time thereafter. If they | 126system call is made, or asynchronously, at any time thereafter. 127If they |
126are detected at call time, 127.Fn aio_read 128returns -1 and sets 129.Va errno 130appropriately; otherwise the 131.Fn aio_return 132system call must be called, and will return -1, and 133.Fn aio_error --- 79 unchanged lines hidden --- | 128are detected at call time, 129.Fn aio_read 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 --- 79 unchanged lines hidden --- |