diff options
Diffstat (limited to 'lib/libc/sys/aio_read.2')
-rw-r--r-- | lib/libc/sys/aio_read.2 | 28 |
1 files changed, 19 insertions, 9 deletions
diff --git a/lib/libc/sys/aio_read.2 b/lib/libc/sys/aio_read.2 index 9e6b532..524daaf 100644 --- a/lib/libc/sys/aio_read.2 +++ b/lib/libc/sys/aio_read.2 @@ -85,6 +85,12 @@ member of that structure references must remain valid until the operation has completed. For this reason, use of auto (stack) variables for these objects is discouraged. .Pp +The asynchronous I/O control buffer +.Ar iocb +should be zeroed before the +.Fn aio_read +call to avoid passing bogus context information to the kernel. +.Pp Modifications of the Asynchronous I/O Control Block structure or the buffer contents after the request has been enqueued, but before the request has completed, are not allowed. @@ -96,12 +102,6 @@ is past the offset maximum for no I/O will occur. .Sh RETURN VALUES .Rv -std aio_read -.Sh STANDARDS -The -.Fn aio_read -call conforms to the -.St -p1003.2 -standard. .Sh DIAGNOSTICS None. .Sh ERRORS @@ -127,7 +127,7 @@ returns -1 and sets appropriately; otherwise the .Fn aio_return function must be called, and will return -1, and -Fn aio_error +.Fn aio_error must be called to determine the actual calue that would have been returned in .Ar errno . @@ -176,14 +176,24 @@ The offset .Ar iocb->aio_offset would be invalid. .El +.Sh STANDARDS +The +.Fn aio_read +call is expected to conform to the +.St -p1003.2 +standard. .Sh HISTORY The .Nm -Function first appeared in +function first appeared in .Fx 3.0 . .Sh AUTHOR This manual page was written by .An Terry Lambert Aq terry@whistle.com . .Sh BUGS -The value of iocb->aio_offset is ignored. +The value of +.Ar iocb->aio_offset +is ignored. Invalid information in +.Ar iocb->_aiocb_private +may confuse the kernel. |