LOCKF

名前

書式

int lockf(int fd, int cmd, off_t len);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

lockf():

_XOPEN_SOURCE >= 500
    || /* Glibc 2.19 以降: */ _DEFAULT_SOURCE
    || /* glibc 2.19 以前: */ _BSD_SOURCE || _SVID_SOURCE

説明

Linux では、 lockf() は単に fcntl(2) のロックへのインターフェースである。 多くの他のシステムで lockf() はこのように実装されているが、 POSIX.1 では lockf() と fcntl(2) のロックとの関係は規定されていない。 おそらく、移植性が必要なアプリケーションでは、 lockf() と fcntl(2) のロックを混ぜて呼び出すのは避けるべきであろう。

有効なオプションを以下に挙げる。

F_LOCK

ファイルの指定されたセクションに排他ロックを設定する。 そのセクション (の一部) が既にロックされていた場合、 前のロックが解除されるまで関数の呼び出しがブロックされる。 このセクションが前にロックされているセクションと重なった場合、 2 つのセクションは結合される。 ロックを保持しているプロセスが、 そのファイルのファイルディスクリプターをクローズすると、 ファイルロックは解放される。 子プロセスはロックを継承しない。

F_TLOCK

F_LOCK と同様であるが、ファイルが既にロックされている場合、 関数の呼び出しはブロックを行わずにエラーを返す。

F_ULOCK

ファイルの指定されたセクションのロックを解除する。 これによりロックされたセクションが 2 つに分割されるかもしれない。

F_TEST

次のようにロックのテストをする。 指定されたセクションがロックされていないか、 このプロセスによりロックされている場合、0 を返す。 他のプロセスがロックを保持している場合、-1 を返し、 errno を EAGAIN (いくつかの他のシステムでは EACCES) に設定する。

返り値

エラー

EACCES か EAGAIN

ロックされたファイルに対して、 F_TLOCK または F_TEST が指定されている。 または、ファイルが他のプロセスによりメモリーマップされており、 指定された操作が禁止されている。

EBADF

fd がオープンされたファイルのディスクリプターではない。 または、 cmd が F_LOCK か F_TLOCK で、 fd が書き込み可能なファイルディスクリプターでない。

EDEADLK

コマンドが F_LOCK であり、このロック操作を行うとデッドロックが発生してしまう。

EINTR

ロックの獲得を待っている間に、ハンドラーにより捕捉されたシグナルを 受信し、 flock() が中断された。 signal(7) 参照。

EINVAL

cmd に無効な操作が指定された。

ENOLCK

非常に多くのセグメントロックが開かれ、ロックテーブルが一杯である。

属性

準拠

関連項目

Linux カーネルソースの Documentation/filesystems ディレクトリにある locks.txt と mandatory-locking.txt (以前のカーネルでは、これらのファイルは Documentation ディレクトリ直下にあり、 mandatory-locking.txt は mandatory.txt という名前であった。)  

この文書について

Index

名前

書式

説明

返り値

エラー

属性

準拠

関連項目

この文書について