Section (2) io_setup
Name
io_setup — create an asynchronous I/O context
Synopsis
#include <linux/aio_abi.h> /* Defines needed types */
int
io_setup( |
unsigned nr_events, |
aio_context_t *ctx_idp) ; |
![]() |
Note |
---|---|
There is no glibc wrapper for this system call; see NOTES. |
DESCRIPTION
The io_setup
() system call
creates an asynchronous I/O context suitable for concurrently
processing nr_events
operations. The ctx_idp
argument must not point
to an AIO context that already exists, and must be
initialized to 0 prior to the call. On successful creation of
the AIO context, *ctx_idp
is filled in with the
resulting handle.
ERRORS
- EAGAIN
-
The specified
nr_events
exceeds the user_zsingle_quotesz_s limit of available events, as defined in/proc/sys/fs/aio-max-nr
. - EFAULT
-
An invalid pointer is passed for
ctx_idp
. - EINVAL
-
ctx_idp
is not initialized, or the specifiednr_events
exceeds internal limits.nr_events
should be greater than 0. - ENOMEM
-
Insufficient kernel resources are available.
- ENOSYS
-
io_setup
() is not implemented on this architecture.
CONFORMING TO
io_setup
() is Linux-specific
and should not be used in programs that are intended to be
portable.
NOTES
Glibc does not provide a wrapper function for this system
call. You could invoke it using syscall(2). But instead,
you probably want to use the io_setup
() wrapper function provided by
libaio
.
Note that the libaio
wrapper function uses
a different type (io_context_t
*) for the ctx_idp
argument. Note also
that the libaio
wrapper does not follow the usual C library conventions for
indicating errors: on error it returns a negated error number
(the negative of one of the values listed in ERRORS). If the
system call is invoked via syscall(2), then the return
value follows the usual conventions for indicating an error:
−1, with errno
set to a
(positive) value that indicates the error.
COLOPHON
This page is part of release 4.16 of the Linux man-pages
project. A
description of the project, information about reporting bugs,
and the latest version of this page, can be found at
https://www.kernel.org/doc/man−pages/.
Copyright (C) 2003 Free Software Foundation, Inc. %%%LICENSE_START(GPL_NOVERSION_ONELINE) This file is distributed according to the GNU General Public License. %%%LICENSE_END |