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 错误代码。