函数名

pthread_mutex_lock, pthread_mutex_trylock, pthread_mutex_unlock - lock and unlock a mutex

SYNOPSIS

概要

#include <pthread.h>

int pthread_mutex_lock(pthread_mutex_t *mutex);
int pthread_mutex_trylock(pthread_mutex_t *mutex);
int pthread_mutex_unlock(pthread_mutex_t *mutex);

描述

pthread_mutex_lock()函数锁住由mutex指定的mutex 对象。如果mutex已经被锁住，调用这个函数的线程阻塞直到mutex可用为止。这跟函数返回的时候参数mutex指定的mutex对象变成锁住状态，同时该函数的调用线程成为该mutex对象的拥有者。

如果mutex 对象的type是 PTHREAD_MUTEX_NORMAL，不进行deadlock detection(死锁检测)。企图进行relock 这个mutex会导致deadlock. 如果一个线程对未加锁的或已经unlock的mutex对象进行unlock操作，结果是不未知的。

如果mutex类型是 PTHREAD_MUTEX_ERRORCHECK，那么将进行错误检查。如果一个线程企图对一个已经锁住的mutex进行relock，将返回一个错误。如果一个线程对未加锁的或已经unlock的mutex对象进行unlock操作，将返回一个错误。

如果mutex类型是 PTHREAD_MUTEX_RECURSIVE，mutex会有一个锁住次数（lock count）的概念。当一个线程成功地第一次锁住一个mutex的时候，锁住次数（lock count）被设置为1，每一次一个线程unlock这个mutex的时候，锁住次数（lock count）就减1。当锁住次数（lock count）减少为0的时候，其他线程就能获得该mutex锁了。如果一个线程对未加锁的或已经unlock的mutex对象进行unlock操作，将返回一个错误。

如果mutex类型是 PTHREAD_MUTEX_DEFAULT，企图递归的获取这个mutex的锁的结果是不确定的。unlock一个不是被调用线程锁住的mutex的结果也是不确定的。企图unlock一个未被锁住的mutex导致不确定的结果。

pthread_mutex_trylock()调用在参数mutex指定的mutex对象当前被锁住的时候立即返回，除此之外，pthread_mutex_trylock()跟pthread_mutex_lock()功能完全一样。

The pthread_mutex_unlock()函数释放有参数mutex指定的mutex对象的锁。如果被释放取决于该Mutex对象的类型属性。如果有多个线程为了获得该mutex锁阻塞，调用pthread_mutex_unlock()将是该mutex可用，一定的调度策略将被用来决定哪个线程可以获得该mutex锁。（在mutex类型为PTHREAD_MUTEX_RECURSIVE 的情况下，只有当lock count 减为0并且调用线程在该mutex上已经没有锁的时候）（翻译到这里，才觉得我的这个锁概念是多么模糊）

如果一个线程在等待一个mutex锁得时候收到了一个signal,那么在从signal handler返回的时候，该线程继续等待该mutex锁，就像这个线程没有被中断一样。

返回值

成功，pthread_mutex_lock() 和 pthread_mutex_unlock() 返回0，否则返回一个错误的提示码

pthread_mutex_trylock() 在成功获得了一个mutex的锁后返回0，否则返回一个错误提示码

错误

pthread_mutex_lock() 和 pthread_mutex_unlock()失败的时候

[EINVAL]

mutex在生成的时候，它的protocol属性的值是 PTHREAD_PRIO_PROTECT，同时调用线程的优先级(priority)比该mutex的当前prority上限高

pthread_mutex_trylock() 函数在一下情况会失败：

[EBUSY]

The mutex could not be acquired because it was already locked.

mutex已经被锁住的时候无法再获取锁

The pthread_mutex_lock(), pthread_mutex_trylock() and pthread_mutex_unlock() functions may fail if:

[EINVAL]

mutex指向的mutex未被初始化

[EAGAIN]

Mutex的lock count(锁数量)已经超过 递归索的最大值，无法再获得该mutex锁

pthread_mutex_lock() 函数在一下情况下会失败：

[EDEADLK]

当前线程已经获得该mutex锁

pthread_mutex_unlock() 函数在以下情况下会失败：

[EPERM]

当前线程不是该mutex锁的拥有者

所有的这些函数的错误返回值都不会是[EINTR]