diff options
author | wes <wes@FreeBSD.org> | 1999-07-01 19:58:12 +0000 |
---|---|---|
committer | wes <wes@FreeBSD.org> | 1999-07-01 19:58:12 +0000 |
commit | 4a9c6f5d1b372ec787c385c50a0cbcb632aeec30 (patch) | |
tree | ff6208a45b059fe7d85ebceed50157ad3b1d2e71 /lib/libc/sys/aio_read.2 | |
parent | f14aea7953bd22f80bc04b5b5f8a3100b4796611 (diff) | |
download | FreeBSD-src-4a9c6f5d1b372ec787c385c50a0cbcb632aeec30.zip FreeBSD-src-4a9c6f5d1b372ec787c385c50a0cbcb632aeec30.tar.gz |
Add mising aio_* man pages. Fixed a minor typo in aio_read.2,
and "corrected" statement of Posix conformance.
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. |