pthread_mutex_consistent 子例程
用途
将稳健互斥的受保护状态标记为一致。
库
线程库 (libpthreads.a)
语法
#include <pthread.h>
int pthread_mutex_consistent(pthread_mutex_t *mutex);
描述
通过调用 pthread_mutex_consistent 子例程将 mutex 参数指定的互斥对象标记为一致。
当包含稳健互斥对象的线程终止时,获取互斥对象的下一个线程将通过 EOWNERDEAD 错误代码通知终止。 互斥对象标记为不一致,对 pthread_mutex_consistent 子例程的调用将稳健互斥对象的受保护状态标记为一致。
当包含稳健互斥对象的线程在处于不一致状态时终止时,获取互斥对象的下一个线程将收到有关终止的通知。 健壮的互斥对象仍处于不一致状态。 如果 pthread_mutex_consistent 子例程失败,那么不会更改稳健互斥对象的状态。
参数
| 项 | 描述 |
|---|---|
| mutex | 指定必须标记为一致的互斥对象。 |
返回值
成功完成时, pthread_mutex_consistent 子例程返回值 0 (0)。 否则,将返回错误代码以指示错误。
错误代码
由于以下错误, pthread_mutex_consistent 子例程可能会失败:
| 项 | 描述 |
|---|---|
| EINVAL | 由 mutex 参数指定的互斥对象不是已初始化的互斥对象,或者不是健壮的,或者不保护不一致的状态。 |
pthread_mutex_consistent 子例程不返回 EINTR 错误代码。