Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

aio_fsync-异步文件同步

语法

＃包括

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

与-lrt链接。

说明

aio_fsync()函数对与aiocbp-> aio_fildes相关的所有未完成的异步I / O操作进行同步。 (有关aiocb结构的说明，请参见aio(7)。)

更准确地说，如果op是O_SYNC，则所有当前排队的I / O操作都应通过调用fsync(2)来完成，并且如果op是O_DSYNC，则此调用是fdatasync(2)的异步模拟。

请注意，这仅是一个请求；它不等待I / O完成。

除了aio_fildes之外，此调用使用的aiocbp指向的结构中的唯一字段是aio_sigevent字段(一个sigevent结构，在sigevent(7)中描述)，它指示完成时所需的异步通知类型。所有其他字段将被忽略。

返回值

成功时(同步请求已成功排队)，此函数返回0。错误时，返回-1，并正确设置errno。

错误说明

EAGAIN

资源不足。

EBADF

aio_fildes不是一个有效的文件描述符，可以打开以进行写入。

EINVAL

此文件不支持同步I / O，或者op不是O_SYNC或O_DSYNC。

ENOSYS

未实现aio_fsync()。

版本

从glibc 2.1开始，可以使用aio_fsync()函数。

属性

有关本节中使用的术语的说明，请参见attribute(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)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。