.\" Copyright (C) 2003 Free Software Foundation, Inc.
.\" This file is distributed according to the GNU General Public License.
.\" See the file COPYING in the top level source directory for details.
.\"
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "IO_SUBMIT" 2 "2003-02-21" "Linux 2.4" "Linux Programmer's Manual"
.SH NAME
io_submit \- Submit asynchronous I/O blocks for processing
.SH "SYNOPSIS"
.ad l
.hy 0

#include <linux/aio.h>
.sp
.HP 16
int\ \fBio_submit\fR\ (aio_context_t\ \fIctx_id\fR, long\ \fInr\fR, struct\ iocb\ \fI**iocbpp\fR);
.ad
.hy

.SH "DESCRIPTION"

.PP
\fBio_submit\fR() queues \fInr\fR I/O request blocks for processing in 
the AIO context \fIctx_id\fR. \fIiocbpp\fR should be an array of 
\fInr\fR AIO request blocks, which will be submitted to context \fIctx_id\fR.

.SH "RETURN VALUE"

.PP
\fBio_submit\fR() returns the number of \fIiocb\fRs submitted and 
0 if \fInr\fR is zero.

.SH "ERRORS"

.TP
EINVAL
The \fIaio_context\fR specified by \fIctx_id\fR is invalid. 
\fInr\fR is less than 0. The \fIiocb\fR at *iocbpp[0] is not properly 
initialized, or the operation specified is invalid for the file descriptor 
in the \fIiocb\fR.

.TP
EFAULT
One of the data structures points to invalid data.

.TP
EBADF
The file descriptor specified in the first \fIiocb\fR is invalid.

.TP
EAGAIN
Insufficient resources are available to queue any \fIiocb\fRs.

.TP
ENOSYS
\fBio_submit\fR() is not implemented on this architecture.

.SH "CONFORMING TO"

.PP
\fBio_submit\fR() is Linux specific and should not be used in programs that are intended to be portable.

.SH "VERSIONS"

.PP
The asynchronous I/O system calls first appeared in Linux 2.5, August 2002.

.SH "SEE ALSO"

.PP
\fBio_setup\fR(2), \fBio_destroy\fR(2), \fBio_getevents\fR(2), \fBio_cancel\fR(2).

.SH "NOTES"

.PP
The asynchronous I/O system calls were written by Benjamin LaHaise.

.SH AUTHOR
Kent Yoder.