2017-09-15
man-pages-ru
Russian man pages from the Linux Documentation Project
manpages-dev
Manual pages about using GNU/Linux for development
man-pages
Linux kernel and C library user-space interface documentation
ИМЯ
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).
Интерфейс | Атрибут | Значение |
aio_fsync() | Безвредность в нитях | MT-Safe |
СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008.