.\" Copyright (C) 2003 Free Software Foundation, Inc.
+.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" This file is distributed according to the GNU General Public License.
-.\" See the file COPYING in the top level source directory for details.
+.\" %%%LICENSE_END
.\"
-.TH IO_SUBMIT 2 2012-05-08 "Linux" "Linux Programmer's Manual"
+.TH IO_SUBMIT 2 2012-07-13 "Linux" "Linux Programmer's Manual"
.SH NAME
io_submit \- submit asynchronous I/O blocks for processing
-.SH "SYNOPSIS"
+.SH SYNOPSIS
.nf
.BR "#include <linux/aio_abi.h>" " /* Defines needed types */"
.BI "int io_submit(aio_context_t " ctx_id ", long " nr \
", struct iocb **" iocbpp );
.fi
-.SH "DESCRIPTION"
+
+.IR Note :
+There is no glibc wrapper for this system call; see NOTES.
+.SH DESCRIPTION
.PP
The
.BR io_submit ()
.I iocbpp
argument should be an array of \fInr\fP AIO control blocks,
which will be submitted to context \fIctx_id\fP.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
On success,
.BR io_submit ()
returns the number of \fIiocb\fPs submitted (which may be
0 if \fInr\fP is zero).
For the failure return, see NOTES.
-.SH "ERRORS"
+.SH ERRORS
.TP
.B EAGAIN
Insufficient resources are available to queue any \fIiocb\fPs.
.B ENOSYS
.BR io_submit ()
is not implemented on this architecture.
-.SH "VERSIONS"
+.SH VERSIONS
.PP
The asynchronous I/O system calls first appeared in Linux 2.5.
-.SH "CONFORMING TO"
+.SH CONFORMING TO
.PP
.BR io_submit ()
is Linux-specific and should not be used in
indicating an error: \-1, with
.I errno
set to a (positive) value that indicates the error.
-.SH "SEE ALSO"
+.SH SEE ALSO
.BR io_cancel (2),
.BR io_destroy (2),
.BR io_getevents (2),
.BR aio (7)
.\" .SH AUTHOR
.\" Kent Yoder.
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.