AIO_FSYNC

Section: Linux Programmer's Manual (3)
Updated: 2017-09-15
Index JM Home Page
 

名前

aio_fsync - 非同期ファイルを同期させる  

書式

#include <aio.h>

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 の完了の待ち合わせは行わない。

aiocbp で指される構造体のフィールドのうち、この呼び出しで aio_fildes 以外に使用されるのは aio_sigevent フィールド (sigevent 構造体、説明は sigevent(7) 参照) のみである。このフィールドは、完了時の非同期通知に使用 したいタイプを示す。 その他のフィールドは無視される。  

返り値

成功した場合 (同期リクエストをキューに入れるのに成功した場合)、 この関数は 0 を返す。 エラーの場合、-1 が返され、 errno が適切に設定される。  

エラー

EAGAIN
リソースが足りない。
EBADF
aio_fildes が書き込みのためにオープンされた有効なファイルディスクリプターではない。
EINVAL
このファイルでは同期 I/O がサポートされていない。 または op が O_SYNC でも O_DSYNC でもない。
ENOSYS
aio_fsync() は実装されていない。
 

バージョン

The aio_fsync() 関数は glibc 2.1 以降で利用できる。  

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース 属性 値
aio_fsync() Thread safety MT-Safe
 

準拠

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)  

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

関連キーワード

fsync   非同期   同期   完了   fildes   構造体   操作   キュー   リクエスト   成功   struct   aiocb   関連   正確   sigevent   通知   タイプ   リソース   書き込み   オープン   サポート   実装   用語   allbox   インターフェース

Linux マニュアル 一覧

関連するコマンド・関数

aio_error.3   aio_return.3   aio_read.3   aio_write.3   aio.7   aio_suspend.3
 

Index

名前
書式
説明
返り値
エラー
バージョン
属性
準拠
関連項目
この文書について

This document was created by man2html, using the manual pages.
Time: 04:39:24 GMT, October 11, 2026