fcntl(2)

以下の特性を持つ新しいファイル記述子を返します。

ファイル記述子 fildes に対応する実行時クローズフラグを取ります。 下位ビットが 0 であった場合、そのファイルは exec(2) のあともオープンしたままですが、そうでないときは、そのファイルは exec(2) の実行時にクローズされます。

fildes に対応する実行時クローズフラグに、 int 型の整数として扱われる第 3 引き数 arg の下位ビットをセットします (F_GETFD を参照)。

ファイルステータス フラグとアクセスモードを調べます。 fcntl(5) を参照してください。

ファイルステータス フラグを int 型の整数として扱われる第 3 引き数 arg にセットします。特定のフラグだけがセットされます。 fcntl(5) を参照してください。 O_NDELAY と O_NONBLOCK の両方をセットすることはできません。

struct flock 型のポインタとして扱われる第 3 引き数、 arg が指す struct flock 型の変数で指定されたロックをブロックしている最初のロックを取得します。得られた情報によって、 fcntl() に渡された flock 構造体の中の情報は上書きされます。 このロックの生成を妨げるロックが見つからなかった場合、その構造体が何も 変更されずに返されます。ただし、ロックのタイプが F_UNLCK にセットされます。

struct flock 型のポインタとして扱われる第 3 引き数 arg が指す struct flock 型の変数にしたがって、ファイルセグメントをセットあるいはクリアします fcntl(5) を参照)。 cmd F_SETLK は読取り (F_RDLCK) と書込み (F_WRLCK) のロックを確立し、また、どちらかのタイプのロック (F_UNLCK) を削除するために使います。 読取りあるいは書込みのロックがセットできない場合、 fcntl() はただちにエラー値 -1 を返します。

この cmd は F_SETLK と同じですが、読取りあるいは書込みのロックが別のロックによって ブロックされたとき、そのセグメントが解放され、それがロックされる まで、そのプロセスがスリープするという点が異なります。

fildes がソケットを示す場合、 fcntl() は、 帯域外のデータが使用可能なときに シグナル SIGURG を受信するために指定された、 プロセス ID またはプロセスグループ ID を返します。 正の値はプロセス ID を示します。 -1 以外の負の値はプロセスグループ ID を示します。

fildes がソケットを示す場合、 fcntl() は、 帯域外のデータが使用可能なときに シグナル SIGURG を受信するために指定された、 プロセス ID またはプロセスグループ ID を設定します。 この設定を行うとき、3 番目の引き数 arg の値を int 型として使用します。 正の値はプロセス ID を示します。 -1 以外の負の値はプロセスグループ ID を示します。

arg が struct flock の代わりに struct flock64 のポインタである以外は、 F_GETLK と同じです。

arg が struct flock の代わりに struct flock64 のポインタである以外は、 F_SETLK と同じです。

arg が struct flock の代わりに struct flock64 のポインタである以外は、 F_SETLKW と同じです。

読取りロックは、その他のプロセスがプロテクトされた部分に 書込みロックすることを禁止します。 ある時点のあるファイルのあるセグメントに対し、 複数の読取りロックが可能です。 読取りロックを行おうとするファイル記述子は、読取りアクセスでオープン されていなければなりません。

書込みロックにより、他のプロセスはそのプロテクトされた部分に 読取りロックや書込みロックができなくなります。 ある時点では、1 つのファイルのあるセグメントに対しては、1 つの書込みロックのみが可能できます。 書込みロックが置かれるファイル記述子は書込みアクセスでオープンされて いなければなりません。

構造体 flock は、影響を受けるファイルのセグメントの タイプ (l_type)、 開始オフセット (l_whence)、 相対オフセット (l_start)、 大きさ (l_len)、 およびプロセス ID (l_pid) を記述します。 プロセス ID フィールドは、ロックされているブロックの値を返すために F_GETLK cmd のみで使われます。 ロックは、現在のファイルの終わりから開始したり、それを超えて拡張したり できますが、ファイルの先頭からの負の相対値にはできません。 ロックは、 l_len に 0 をセットすることにより、いつでもファイルの終わりまで拡張することができます。 そのようなロックで、 l_start が 0 にセットされていた場合、ファイル全体がロックされます。 あるセグメントを、それよりも大きなロックされたセグメントの中から、変更したり ロックを解除したりした場合、2 つの小さなセグメントが一方の端に残ります。 呼び出したプロセスによってすでにロックされているセグメントをロック すると、古いロックタイプが消去され、新しいロックタイプが有効となります。 あるプロセスのファイルに対応するすべてのロックは、そのファイルの ファイル記述子がそのプロセスによってクローズされるか、 そのファイル記述子を持つプロセスが終了したときに削除されます。 ロックは fork(2) システムコールによって子プロセスに継承されません。

強制モードのファイルやレコードのロックが、あるファイルでアクティブにされた とき chmod(2) を参照)、それ以降のそのファイルへの read() や write() システムコールは有効なレコードロックによる影響を受けます。

fcntl(2) の通知レコードロック機能は「ネットワーク ロックデーモン」によって ネットワークを使って実現されています lockd(1M) を参照)。 ファイルサーバがクラッシュして再ブートしたとき、ロックデーモンは そのクラッシュしたサーバに対応するすべてのロックを復旧しようとします。 ロックが戻せないとき、そのロックを持っていたプロセスに SIGLOST シグナル が送られます。

レコードロックは NFS ファイルのために実現されていますので、通知だけです。

新しいファイル記述子

実行時クローズフラグの値 (下位ビットだけが定義されている)

-1 以外の値

ファイルステータス フラグとアクセスモードの値

-1 以外の値

-1 以外の値

-1 以外の値

-1 以外の値

帯域外のデータが使用可能なときに シグナル SIGURG を受信するために指定された、プロセス ID またはプロセスグループ ID の値

-1 以外の値

-1 以外の値

-1 以外の値

-1 以外の値

fildes が正しい開いているファイル記述子でないか、あるいは読取りロックをセットしようとしたときに読取りでオープンしていないか、書込みロックセットしようとしたときに書込みでオープンしていない場合

cmd が F_DUPFD で、現在最大値のファイル記述子がオープンされている場合

cmd が F_SETLK または F_SETLKW であり、ロックのタイプが読取りか書込みロックであり、かつ利用可能な ファイルロック ヘッダがない (ロックされたセグメントを 持つファイルが多すぎる) 場合

cmd が F_DUPFD であり、 arg が、ファイル記述子の最大値以上である場合

cmd が F_DUPFD であり、 arg が負である場合

cmd が F_GETLK、 F_SETLK、 または F_SETLKW、 であり、 arg あるいはそれが指すデータが正当でないか、あるいはファイルを指す fildes がロックをサポートしていない場合

cmd が正しいコマンドでない場合

cmd が F_SETFL であり、 O_NONBLOCK と O_NDELAY の両方が指定されている場合

cmd が F_SETLKW であり、呼出しがシグナルによって割り込まれた場合

cmd が F_SETLK であり、ロックのタイプ (l_type) が読取りロック (F_RDLCK) か書込みロック (F_WRLCK) であり、かつロックしようとしているファイルのセグメントがすでに別の プロセスによって書込みロックされているか、あるいは タイプが書込みロック (F_WRLCK) であり、かつロックしようとしているファイルのセグメントがすでに別の プロセスによって読取りあるいは書込みロックされている場合

cmd が F_SETLK または F_SETLKW で、ロックのタイプが読取りまたは書込みロックであり、かつ利用可能な ファイルロック ヘッダがない (ロックされたセグメントを持つファイルが 多過ぎる) か、あるいは利用可能なレコードロックがない (ロックされた ファイルセグメントが多過ぎる) 場合

cmd が F_SETLK または F_SETLKW であり、ロックのタイプ (l_type) が読取りロック (F_RDLCK) あいるは書込みロック (F_WRLCK) であり、かつそのファイルが NFS ファイルで、アクセスビットが強制モードにセットされている場合

cmd が F_GETLK、 F_SETLK、 あるいは F_SETLKW であり、そのファイルが NFS ファイルであり、かつシステムエラーがリモートノードで発生した場合

cmd が F_GETLK であり、ブロックしているロックの開始オフセット (長さ) が 呼び出し元の構造体に入らない場合

ロックが別のプロセスからのロックでブロックされて、その ロックが解放されるのをスリープしている (待っている) ときに、 cmd が F_SETLKW であった場合。これはデッドロックになります。

cmd が F_SETLK または F_SETLKW であり、そのファイルが mmap() システムコール mmap(2) を参照) によって仮想メモリにマップされている場合

cmd が F_GETLK、 F_SETLK のどちらかであるか、または F_SETLKW であり、かつ arg が正しくないアドレス指している場合 points to an illegal address.

cmd が F_GETOWN または F_SETOWN であり、かつ fildes がソケットを示さない場合