manページ  — PTHREAD_RWLOCK_INIT

pthread_rwlock_init – 読取り / 書込みロックの初期化

ライブラリ 書式 解説 戻り値 関連項目 規格 エラー 歴史 バグ

Reentrant C\~Library (libc_r, -lc_r)

#include <pthread.h>

int
pthread_rwlock_init(pthread_rwlock_t *lock, const pthread_rwlockattr_t *attr);

pthread_rwlock_init() 関数は、 attr で指定された属性で、読取り / 書込みロックを初期化するために使用されます。 attr が NULL の場合には、デフォルトの読取り / 書込みロック属性が使用されます。

既に初期化されているロックでの pthread_rwlock_init() の呼び出しの結果は、未定義です。

問題がない場合は、 pthread_rwlock_init() 関数は 0 を返します。 問題がある場合は、そのエラーを示すためにエラー番号が返されます。

pthread_rwlock_init() 関数は、 Version 2 of the Single UNIX Specification に適合しているはずです。

pthread_rwlock_init() 関数は、以下の場合に失敗します。

[EAGAIN]
	ロックを初期化するために必要な (メモリ以外の) リソースが、 システムに不足しています。
[ENOMEM]
	ロックを初期化するための十分なメモリがありません。
[EPERM]
	呼び出し側が、その操作を実行するための十分な権利を持っていません。

pthread_rwlock_init() 関数は、以下の場合に失敗することがあります。

[EBUSY]
	lock によって参照されているオブジェクトで、 以前に初期化されているがまだ破壊されていない読取り / 書込みロックを 再初期化しようとしていることを、システムが検出しました。
[EINVAL]
	attr によって指定された値が無効です。

pthread_rwlock_init() 関数は、 FreeBSD 3.0 ではじめて登場しました。

PTHREAD_PROCESS_SHARED 属性は、サポートされていません。