From c4e453903d23a174b74d856cba2be7803583725c Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 11 Jun 2008 13:57:31 +0000 Subject: [PATCH] Re-order ERRORS and SEE ALSO entries to be alphabetical. --- man2/io_cancel.2 | 11 +++++------ man2/io_destroy.2 | 13 ++++++------- man2/io_getevents.2 | 12 ++++++------ man2/io_setup.2 | 17 ++++++++--------- man2/io_submit.2 | 25 ++++++++++++------------- 5 files changed, 37 insertions(+), 41 deletions(-) diff --git a/man2/io_cancel.2 b/man2/io_cancel.2 index 69bf8f6ec..483975ec7 100644 --- a/man2/io_cancel.2 +++ b/man2/io_cancel.2 @@ -55,14 +55,14 @@ returns 0 on success; on failure, it returns one of the errors listed under ERRORS. .SH "ERRORS" .TP -.B EINVAL -The AIO context specified by \fIctx_id\fP is invalid. +.B EAGAIN +The \fIiocb\fP specified was not canceled. .TP .B EFAULT One of the data structures points to invalid data. .TP -.B EAGAIN -The \fIiocb\fP specified was not canceled. +.B EINVAL +The AIO context specified by \fIctx_id\fP is invalid. .TP .B ENOSYS .BR io_cancel () @@ -76,10 +76,9 @@ The asynchronous I/O system calls first appeared in Linux 2.5, August 2002. is Linux-specific and should not be used in programs that are intended to be portable. .SH "SEE ALSO" -.PP -.BR io_setup (2), .BR io_destroy (2), .BR io_getevents (2), +.BR io_setup (2), .BR io_submit (2) .\" .SH "NOTES" .\" diff --git a/man2/io_destroy.2 b/man2/io_destroy.2 index 6c509316d..fb659c89c 100644 --- a/man2/io_destroy.2 +++ b/man2/io_destroy.2 @@ -52,12 +52,12 @@ returns 0 on success; on failure, it returns one of the errors listed under ERRORS. .SH "ERRORS" .TP -.B EINVAL -The AIO context specified by \fIctx\fP is invalid. -.TP .B EFAULT The context pointed to is invalid. .TP +.B EINVAL +The AIO context specified by \fIctx\fP is invalid. +.TP .B ENOSYS .BR io_destroy () is not implemented on this architecture. @@ -70,11 +70,10 @@ The asynchronous I/O system calls first appeared in Linux 2.5, August 2002. is Linux-specific and should not be used in programs that are intended to be portable. .SH "SEE ALSO" -.PP -.BR io_setup (2), -.BR io_submit (2), +.BR io_cancel (2), .BR io_getevents (2), -.BR io_cancel (2) +.BR io_setup (2), +.BR io_submit (2) .\" .SH "NOTES" .\" .\" .PP diff --git a/man2/io_getevents.2 b/man2/io_getevents.2 index 183038275..caebf85d4 100644 --- a/man2/io_getevents.2 +++ b/man2/io_getevents.2 @@ -60,14 +60,14 @@ available or < \fImin_nr\fP if the \fItimeout\fP has elapsed; on failure, it returns one of the errors listed under ERRORS. .SH "ERRORS" .TP +.B EFAULT +Either \fIevents\fP or \fItimeout\fP is an invalid pointer. +.TP .B EINVAL \fIctx_id\fP is invalid. \fImin_nr\fP is out of range or \fInr\fP is out of range. .TP -.B EFAULT -Either \fIevents\fP or \fItimeout\fP is an invalid pointer. -.TP .B ENOSYS .BR io_getevents () is not implemented on this architecture. @@ -81,10 +81,10 @@ is Linux-specific and should not be used in programs that are intended to be portable. .SH "SEE ALSO" .PP -.BR io_setup (2), -.BR io_submit (2), .BR io_cancel (2), -.BR io_destroy (2) +.BR io_destroy (2), +.BR io_setup (2), +.BR io_submit (2) .\" .SH "NOTES" .\" .\" .PP diff --git a/man2/io_setup.2 b/man2/io_setup.2 index cd3e92584..576b9e704 100644 --- a/man2/io_setup.2 +++ b/man2/io_setup.2 @@ -53,19 +53,19 @@ returns 0 on success; on failure, it returns one of the errors listed under ERRORS. .SH "ERRORS" .TP -.B EINVAL -\fIctxp\fP is not initialized, or the specified \fInr_events\fP -exceeds internal limits. \fInr_events\fP should be greater than 0. +.B EAGAIN +The specified \fInr_events\fP exceeds the user's limit of available events. .TP .B EFAULT An invalid pointer is passed for \fIctxp\fP. .TP +.B EINVAL +\fIctxp\fP is not initialized, or the specified \fInr_events\fP +exceeds internal limits. \fInr_events\fP should be greater than 0. +.TP .B ENOMEM Insufficient kernel resources are available. .TP -.B EAGAIN -The specified \fInr_events\fP exceeds the user's limit of available events. -.TP .B ENOSYS .BR io_setup () is not implemented on this architecture. @@ -78,11 +78,10 @@ The asynchronous I/O system calls first appeared in Linux 2.5, August 2002. is Linux-specific and should not be used in programs that are intended to be portable. .SH "SEE ALSO" -.PP +.BR io_cancel (2), .BR io_destroy (2), .BR io_getevents (2), -.BR io_submit (2), -.BR io_cancel (2) +.BR io_submit (2) .\" .SH "NOTES" .\" .PP .\" The asynchronous I/O system calls were written by Benjamin LaHaise. diff --git a/man2/io_submit.2 b/man2/io_submit.2 index cc2bfa841..43dd2cfb0 100644 --- a/man2/io_submit.2 +++ b/man2/io_submit.2 @@ -54,6 +54,15 @@ returns the number of \fIiocb\fPs submitted (which may be on failure, it returns one of the errors listed under ERRORS. .SH "ERRORS" .TP +.B EAGAIN +Insufficient resources are available to queue any \fIiocb\fPs. +.TP +.B EBADF +The file descriptor specified in the first \fIiocb\fP is invalid. +.TP +.B EFAULT +One of the data structures points to invalid data. +.TP .B EINVAL The \fIaio_context\fP specified by \fIctx_id\fP is invalid. \fInr\fP is less than 0. @@ -61,15 +70,6 @@ The \fIiocb\fP at *iocbpp[0] is not properly initialized, or the operation specified is invalid for the file descriptor in the \fIiocb\fP. .TP -.B EFAULT -One of the data structures points to invalid data. -.TP -.B EBADF -The file descriptor specified in the first \fIiocb\fP is invalid. -.TP -.B EAGAIN -Insufficient resources are available to queue any \fIiocb\fPs. -.TP .B ENOSYS .BR io_submit () is not implemented on this architecture. @@ -82,11 +82,10 @@ The asynchronous I/O system calls first appeared in Linux 2.5, August 2002. is Linux-specific and should not be used in programs that are intended to be portable. .SH "SEE ALSO" -.PP -.BR io_setup (2), +.BR io_cancel (2), .BR io_destroy (2), -.BR io_getevents (2), -.BR io_cancel (2) +.BR io_getevents (2) +.BR io_setup (2), .\" .SH "NOTES" .\" .PP .\" The asynchronous I/O system calls were written by Benjamin LaHaise.