pthread_mutex_consistent サブルーチン

目的

堅固な mutex の保護状態に整合性のマークを付けます。

ライブラリー

スレッド・ライブラリー (libpthreads.a)

構文

#include <pthread.h>
int pthread_mutex_consistent(pthread_mutex_t *mutex);

説明

mutex パラメーターによって指定された mutex オブジェクトは、 pthread_mutex_consistent サブルーチンを呼び出すことによって整合としてマークされます。

堅固な mutex を保持するスレッドが終了すると、その mutex を獲得する次のスレッドは、 EOWNERDEAD エラー・コードによって終了について通知されます。 mutex に不整合のマークが付けられ、 pthread_mutex_consistent サブルーチンへの呼び出しにより、堅固な mutex の保護状態に整合のマークが付けられます。

堅固な mutex を保持するスレッドが不整合な状態のときに終了すると、その mutex を獲得する次のスレッドに終了が通知されます。 堅固な mutex は不整合状態のままです。 pthread_mutex_consistent サブルーチンが失敗した場合、堅固な mutex の状態は変更されません。

パラメーター

戻り値

正常終了すると、 pthread_mutex_consistent サブルーチンはゼロ (0) の値を戻します。 それ以外の場合は、エラーを示すエラー・コードが戻されます。

エラー・コード

pthread_mutex_consistent サブルーチンは、以下のエラーのために失敗することがあります。

pthread_mutex_consistent サブルーチンは EINTR エラー・コードを戻しません。