Section (3) lio_listio
lio_listio — initiate a list of I/O requests
|struct aiocb *const aiocb_list,|
|struct sigevent *sevp
initiates the list of I/O operations described by the array
has one of the following values:
The call blocks until all operations are complete. The
sevpargument is ignored.
The I/O operations are queued for processing and the call returns immediately. When all of the I/O operations complete, asynchronous notification occurs, as specified by the
sevpargument; see sigevent(7) for details. If
sevpis NULL, no asynchronous notification occurs.
argument is an array of pointers to aiocb structures that describe I/O
operations. These operations are executed in an unspecified
argument specifies the size of the array
aiocb_list. null pointers in
In each control block in
aio_lio_opcode field specifies the I/O
operation to be initiated, as follows:
The remaining fields in each control block have the same
meanings as for aio_read(3) and aio_write(3). The
aio_sigevent fields of each
control block can be used to specify notifications for the
individual I/O operations (see sigevent(7)).
lio_listio() returns 0 if all I/O
operations are successfully queued. Otherwise, −1 is
errno is set to
indicate the error.
lio_listio() returns 0 when all of the I/O
operations have completed successfully. Otherwise, −1
is returned, and
errno is set to
indicate the error.
The return status from
lio_listio() provides information only
about the call itself, not about the individual I/O
operations. One or more of the I/O operations may fail, but
this does not prevent other operations completing. The status
of individual I/O operations in
aiocb_list can be determined
using aio_error(3). When an
operation has completed, its return status can be obtained
using aio_return(3). Individual
I/O operations can fail for the reasons described in
aio_read(3) and aio_write(3).
may fail for the following reasons:
Out of resources.
The number of I/O operations specified by
nitemswould cause the limit
AIO_MAXto be exceeded.
LIO_WAITand a signal was caught before all I/O operations completed; see signal(7). (This may even be one of the signals used for asynchronous I/O completion notification.)
modeis invalid, or
nitemsexceeds the limit
One of more of the operations specified by
aiocb_listfailed. The application can check the status of each operation using aio_return(3).
lio_listio() fails with
the error EAGAIN, EINTR, or EIO, then some of the operations in
aiocb_list may have
been initiated. If
fails for any other reason, then none of the I/O operations
has been initiated.
For an explanation of the terms used in this section, see attributes(7).
It is a good idea to zero out the control blocks before use. The control blocks must not be changed while the I/O operations are in progress. The buffer areas being read into or written from must not be accessed during the operations or undefined results may occur. The memory areas involved must remain valid.
Simultaneous I/O operations specifying the same aiocb structure produce undefined results.
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
Copyright (C) 2010, Michael Kerrisk <mtk.manpagesgmail.com>
This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
The GNU General Public License_zsingle_quotesz_s references to object code
and executables are to be interpreted as the output of any
document formatting or typesetting system, including
intermediate and printed output.
This manual is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public
License along with this manual; if not, see