aio_read.2 (108028) | aio_read.2 (108087) |
---|---|
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 108028 2002-12-18 09:22:32Z ru $ | 25.\" $FreeBSD: head/lib/libc/sys/aio_read.2 108087 2002-12-19 09:40:28Z 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 --- 20 unchanged lines hidden (view full) --- 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 60The 61.Fa iocb->aio_lio_opcode | 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 --- 20 unchanged lines hidden (view full) --- 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 60The 61.Fa iocb->aio_lio_opcode |
62argument |
|
62is ignored by the 63.Fn aio_read 64system call. 65.Pp 66The 67.Fa iocb 68pointer may be subsequently used as an argument to 69.Fn aio_return --- 62 unchanged lines hidden (view full) --- 132system call must be called, and will return -1, and 133.Fn aio_error 134must be called to determine the actual calue that would have been 135returned in 136.Va errno . 137.Pp 138.Bl -tag -width Er 139.It Bq Er EBADF | 63is ignored by the 64.Fn aio_read 65system call. 66.Pp 67The 68.Fa iocb 69pointer may be subsequently used as an argument to 70.Fn aio_return --- 62 unchanged lines hidden (view full) --- 133system call must be called, and will return -1, and 134.Fn aio_error 135must be called to determine the actual calue that would have been 136returned in 137.Va errno . 138.Pp 139.Bl -tag -width Er 140.It Bq Er EBADF |
141The |
|
140.Fa iocb->aio_fildes | 142.Fa iocb->aio_fildes |
143argument |
|
141is invalid. 142.It Bq Er EINVAL 143The offset 144.Fa iocb->aio_offset 145is not valid, the priority specified by 146.Fa iocb->aio_reqprio 147is not a valid priority, or the number of bytes specified by 148.Fa iocb->aio_nbytes --- 15 unchanged lines hidden (view full) --- 164.Xr read 2 165system call, and the value returned by the 166.Fn aio_error 167system call is either one of the error returns from the 168.Xr read 2 169system call, or one of: 170.Bl -tag -width Er 171.It Bq Er EBADF | 144is invalid. 145.It Bq Er EINVAL 146The offset 147.Fa iocb->aio_offset 148is not valid, the priority specified by 149.Fa iocb->aio_reqprio 150is not a valid priority, or the number of bytes specified by 151.Fa iocb->aio_nbytes --- 15 unchanged lines hidden (view full) --- 167.Xr read 2 168system call, and the value returned by the 169.Fn aio_error 170system call is either one of the error returns from the 171.Xr read 2 172system call, or one of: 173.Bl -tag -width Er 174.It Bq Er EBADF |
175The |
|
172.Fa iocb->aio_fildes | 176.Fa iocb->aio_fildes |
177argument |
|
173is invalid for reading. 174.It Bq Er ECANCELED 175The request was explicitly cancelled via a call to 176.Fn aio_cancel . 177.It Bq Er EINVAL 178The offset 179.Fa iocb->aio_offset 180would be invalid. --- 28 unchanged lines hidden --- | 178is invalid for reading. 179.It Bq Er ECANCELED 180The request was explicitly cancelled via a call to 181.Fn aio_cancel . 182.It Bq Er EINVAL 183The offset 184.Fa iocb->aio_offset 185would be invalid. --- 28 unchanged lines hidden --- |