名称

fsync — ファイルへの変更を同期させる

ライブラリ

Standard C Library (libc, -lc)

書式

#include < unistd.h>

int
fsync( int fd);

解説

fsync() システムコールによって、 fd の修正されたすべてのデータと属性は、永続的な記憶デバイスに移動されます。これは、通常、関連したファイルのためのバッファのすべてのコア中の修正されたコピーをディスクに書き込む結果となります。

fsync() システムコールは、例えば、単純なトランザクション機能を構築するときに、既知の状態であることをファイルに要求するプログラムによって使用されるべきです。

戻り値

The fsync() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

fsync() は、次の場合に失敗します:

[ EBADF]

fd 引数が有効な記述子ではありません。

[ EINVAL]

fd 引数がファイルではなくソケットを参照しています。

[ EIO]

ファイルシステムから読み込むか、または書き込む間に、I/O エラーが起こりました。

関連項目

sync(2), syncer(4), sync(8)

歴史

fsync() システムコールは、 4.2BSD で登場しました。