aio_fsync(3) асинхронная файловая синхронизация

ОБЗОР

#include <aio.h>

int aio_fsync(int op, struct aiocb *aiocbp);

Компонуется при указании параметра -lrt.

ОПИСАНИЕ

Функция aio_fsync() выполняет синхронизацию всех ожидающих выполнения асинхронных операций ввода-вывода, связанных с aiocbp->aio_fildes (описание структуры aiocb смотрите в aio(7)).

Более точно, если значение op равно O_SYNC, то все операции ввода-вывода в очереди будут выполнены, как если бы сработал вызов fsync(2), а если op равно O_DSYNC, то данная функция является асинхронным аналогом fdatasync(2).

Заметим, что это только запрос; функция не ожидает завершения выполнения ввода-вывода.

Кроме aio_fildes, в структуре aiocbp используется только поле aio_sigevent (структура sigevent описана в sigevent(7)), в котором указывается желаемый тип асинхронного уведомления по завершению. Все остальные поля игнорируются.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении (запрос синхронизации добавлен в очередь) данная функция возвращает 0. При ошибке возвращается -1, а значение errno устанавливается соответствующим образом.

ОШИБКИ

EAGAIN
Не хватает ресурсов.
EBADF
Значение aio_fildes не является правильным файловым дескриптором, открытым для записи.
EINVAL
Синхронизированный ввод-вывод не поддерживается для этого файла, или значение op не равно O_SYNC или O_DSYNC.
ENOSYS
Функция aio_fsync() не реализована.

ВЕРСИИ

Функция aio_fsync() доступна в glibc начиная с версии 2.1.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).
ИнтерфейсАтрибутЗначение
aio_fsync() безвредность в нитяхбезвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ

POSIX.1-2001, POSIX.1-2008.