ИМЯ

aio_fsync - асинхронная файловая синхронизация

ОБЗОР

#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).

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

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

СМОТРИТЕ ТАКЖЕ

aio_cancel(3), aio_error(3), aio_read(3), aio_return(3), aio_suspend(3), aio_write(3), lio_listio(3), aio(7), sigevent(7)