ОБЗОР
#include <aio.h>
int lio_listio(int mode, struct aiocb *const aiocb_list[],
int nitems, struct sigevent *sevp);
Компонуется при указании параметра -lrt.
ОПИСАНИЕ
Функция lio_listio() запускает на выполнение список операций
ввода-вывода, описанных в массиве aiocb_list.
Значение операции mode может быть одним из следующих:
LIO_WAIT Вызов не завершается до тех пор, пока не будут выполнены все операции. Аргумент sevp игнорируется.
LIO_NOWAIT Операции ввода-вывода ставятся в очередь на обработку и вызов завершается. После выполнения всех операций ввода-вывода посылается асинхронное уведомление, задаваемое в аргументе sevp; подробности смотрите в sigevent(7). Если значение sevp равно NULL, то асинхронные уведомления не посылается.
Аргумент aiocb_list представляет собой массив указателей на структуры aiocb, в которых описаны операции ввода-вывода. Эти операции выполняются в произвольном порядке. В аргументе nitems указывается размер массива aiocb_list. Указатели null в aiocb_list игнорируются.
В каждом управляющем блоке в aiocb_list в поле aio_lio_opcode задаётся выполняемая операция ввода вывода; значения:
LIO_READ Выполнить операцию чтения. Операция ставится в очередь как вызов aio_read(3) с указанным управляющим блоком.
LIO_WRITE Выполнить операцию записи. Операция ставится в очередь как вызов aio_write(3) с указанным управляющим блоком.
LIO_NOP Игнорировать управляющий блок.
Остальные поля в каждом управляющем блоке имеют то же назначение, что и для aio_read(3) и aio_write(3). Поля aio_sigevent в каждом управляющем блоке могут использоваться для указания уведомлений по отдельным операциям ввода-вывода (смотрите sigevent(7)).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При значении mode равным LIO_NOWAIT функция lio_listio() возвращает
0, если все операции ввода-вывода были поставлены в очередь. В противном
случае возвращается -1 и в errno содержится код ошибки.
При значении mode равным LIO_WAIT функция lio_listio() возвращает 0, если все операции ввода-вывода были выполнены без ошибок. В противном случае возвращается -1 и в errno содержится код ошибки.
В возвращаемом lio_listio() состоянии предоставляется информация только о самом вызове, а не об отдельных операция ввода-вывода. Одна или несколько операций ввода-вывода могут завершиться с ошибкой, но это не повлияет на выполнение остальных операций. Состояние отдельный операций ввода-вывода в aiocb_list можно определить с помощью aio_error(3). После завершения операции её результат можно получить с помощью aio_return(3). Отдельные операции ввода-вывода могут завершиться с ошибкой по причинам, описанным в aio_read(3) и aio_write(3).
ОШИБКИ
Функция lio_listio() может завершиться с ошибкой по следующим причинам:
EAGAIN Не хватает ресурсов.
EAGAIN Количество операций ввода-вывода, указанное в nitems, превысило ограничение AIO_MAX.
EINVAL Неправильное значение mode, или значение nitems превышает ограничение AIO_LISTIO_MAX.
EINTR Значение mode равно LIO_WAIT и был получен сигнал до завершения всех операций ввода-вывода; смотрите signal(7) (это может быть даже один из асинхронных сигналов о завершении ввода-вывода).
EIO Одна или более операций, указанных в aiocb_list, завершились с ошибкой. Приложение может проверить состояние каждой операции с помощью aio_return(3).
Если вызов lio_listio() завершился с ошибкой EAGAIN, EINTR или EIO, то некоторые операции из aiocb_list могли всё же начаться. Если вызов lio_listio() завершился по другой причине, то ни одна из операций ввода-вывода не началась.
ВЕРСИИ
Функция lio_listio() доступна в glibc начиная с версии 2.1.
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс Атрибут Значение
lio_listio()
безвредность в потоках: безвредно (MT-Safe)
СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008.
ЗАМЕЧАНИЯ
Рекомендуется обнулять управляющие блоки перед использованием. Управляющие
блоки не должны изменяться пока выполняются операции ввода-вывода. Нельзя
читать или писать в буферные области во время выполнения операций, иначе
результат непредсказуем. Используемые области памяти должны оставаться
корректными (valid).
Одновременное выполнение операций ввода-вывода через совместно используемую структуру aiocb приводит к непредсказуемым результатам.
