線程彙總

setpriority設置程序進程執行優先權
setpriority設置程序進程執行優先權 相關函數:getpriority, nice 表頭文件:#include #include 函數定義:int setpriority(int which, int who, int prio) 函數說明:setpriority()用用來設置進程、進程組和用戶的進程執行優先權。
which who 意義 ------------------------- ------------------------- ------------------------------------------------ 
      PRIO_PROCESS who 爲進程識別碼
      PRIO_PGRP who 爲進程的組識別碼
      PRIO_USER who 爲用戶識別碼
參數prio介於-20 到20之間, 代表進程執行優先權,數值越低代表有效高的優先次序, 執行會較頻繁。
此優先權默認是0, 而只有超級用戶root允許降低此值 返回值 :成功返回0, 失敗返回-1, 錯誤原因存於errno中 ESRCH 參數which或who可能有錯,而找不到符合的進程 EINVAL 參數which值有誤 EPERM 權限不夠,無法完成設置 EACCES 一般用戶無法降低優先權。

int pthread_mutex_init

基本概述

函數原型: int pthread_mutex_init(pthread_mutex_t *restrict mutex,const pthread_mutexattr_t *restrict attr);

該函數用於C函數的多線程編程中,互斥鎖的初始化。

pthread_mutex_init() 函數是以動態方式創建互斥鎖的,參數attr指定了新建互斥鎖的屬性。如果參數attr爲空,則使用默認的互斥鎖屬性,默認屬性爲快速互斥鎖 。互斥鎖的屬性在創建鎖的時候指定,在LinuxThreads實現中僅有一個鎖類型屬性,不同的鎖類型在試圖對一個已經被鎖定的互斥鎖加鎖時表現不同。

pthread_mutexattr_init() 函數成功完成之後會返回零,其他任何返回值都表示出現了錯誤。

函數成功執行後,互斥鎖被初始化爲鎖住態。

編輯本段互斥鎖屬性

使用互斥鎖(互斥)可以使線程按順序執行。通常,互斥鎖通過確保一次只有一個線程執行代碼的臨界段來同步多個線程。互斥鎖還可以保護單線程代碼。

要更改缺省的互斥鎖屬性,可以對屬性對象進行聲明和初始化。通常,互斥鎖屬性會設置在應用程序開頭的某個位置,以便可以快速查找和輕鬆修改。表 4–1 列出了用來處理互斥鎖屬性的函數。

編輯本段初始化互斥鎖屬性對象

使用 pthread_mutexattr_init(3C) 可以將與互斥鎖對象相關聯的屬性初始化爲其缺省值。在執行過程中,線程系統會爲每個屬性對象分配存儲空間。
pthread_mutexattr_init 語法
int pthread_mutexattr_init(pthread_mutexattr_t *mattr);#include <pthread.h> pthread_mutexattr_t mattr;int ret;/* initialize an attribute to default value */ ret = pthread_mutexattr_init(&mattr); 調用此函數時,pshared 屬性的缺省值爲 PTHREAD_PROCESS_PRIVATE。該值表示可以在進程內使用經過初始化的互斥鎖。

mattr 的類型爲 opaque,其中包含一個由系統分配的屬性對象。mattr 範圍可能的值爲 PTHREAD_PROCESS_PRIVATE 和 PTHREAD_PROCESS_SHARED。PTHREAD_PROCESS_PRIVATE 是缺省值。

對於互斥鎖屬性對象,必須首先通過調用 pthread_mutexattr_destroy(3C) 將其銷燬,才能重新初始化該對象。pthread_mutexattr_init() 調用會導致分配類型爲 opaque 的對象。如果未銷燬該對象,則會導致內存泄漏。

pthread_mutexattr_init 返回值
pthread_mutexattr_init() 成功完成之後會返回零。其他任何返回值都表示出現了錯誤。如果出現以下情況,該函數將失敗並返回對應的值。

ENOMEM 描述: 內存不足,無法初始化互斥鎖屬性對象。

編輯本段銷燬互斥鎖屬性對象

pthread_mutexattr_destroy(3C) 可用來取消分配用於維護 pthread_mutexattr_init() 所創建的屬性對象的存儲空間。
pthread_mutexattr_destroy 語法
int pthread_mutexattr_destroy(pthread_mutexattr_t *mattr)#include <pthread.h> pthread_mutexattr_t mattr;int ret;/* destroy an attribute */ ret = pthread_mutexattr_destroy(&mattr);
pthread_mutexattr_destroy 返回值
pthread_mutexattr_destroy() 成功完成之後會返回零。其他任何返回值都表示出現了錯誤。如果出現以下情況,該函數將失敗並返回對應的值。

EINVAL 描述: 由 mattr 指定的值無效。

編輯本段設置互斥鎖的範圍

pthread_mutexattr_setpshared(3C) 可用來設置互斥鎖變量的作用域。
pthread_mutexattr_setpshared 語法
int pthread_mutexattr_setpshared(pthread_mutexattr_t *mattr, int pshared);#include <pthread.h>pthread_mutexattr_t mattr; int ret;ret = pthread_mutexattr_init(&mattr);/* * resetting to its default value: private */ ret = pthread_mutexattr_setpshared(&mattr, PTHREAD_PROCESS_PRIVATE); 互斥鎖變量可以是進程專用的(進程內)變量,也可以是系統範圍內的(進程間)變量。要在多個進程中的線程之間共享互斥鎖,可以在共享內存中創建互斥鎖,並將 pshared 屬性設置爲 PTHREAD_PROCESS_SHARED。 此行爲與最初的 Solaris 線程實現中 mutex_init() 中的 USYNC_PROCESS 標誌等效。

如果互斥鎖的 pshared 屬性設置爲 PTHREAD_PROCESS_PRIVATE,則僅有那些由同一個進程創建的線程才能夠處理該互斥鎖。

pthread_mutexattr_setpshared 返回值
pthread_mutexattr_setpshared() 成功完成之後會返回零。其他任何返回值都表示出現了錯誤。如果出現以下情況,該函數將失敗並返回對應的值。

EINVAL 描述: 由 mattr 指定的值無效。

編輯本段獲取互斥鎖的範圍

pthread_mutexattr_getpshared(3C) 可用來返回由 pthread_mutexattr_setpshared() 定義的互斥鎖變量的範圍。
pthread_mutexattr_getpshared 語法
int pthread_mutexattr_getpshared(pthread_mutexattr_t *mattr, int *pshared);#include <pthread.h>pthread_mutexattr_t mattr; int pshared, ret;/* get pshared of mutex */ ret = pthread_mutexattr_getpshared(&mattr, &pshared); 此函數可爲屬性對象 mattr 獲取 pshared 的當前值。該值爲 PTHREAD_PROCESS_SHARED 或 PTHREAD_PROCESS_PRIVATE。
pthread_mutexattr_getpshared 返回值
pthread_mutexattr_getpshared() 成功完成之後會返回零。其他任何返回值都表示出現了錯誤。如果出現以下情況,該函數將失敗並返回對應的值。

EINVAL 描述: 由 mattr 指定的值無效。

編輯本段設置互斥鎖類型的屬性

pthread_mutexattr_settype(3C) 可用來設置互斥鎖的 type 屬性。
pthread_mutexattr_settype 語法
#include <pthread.h> int pthread_mutexattr_settype(pthread_mutexattr_t *attr , int type); 類型屬性的缺省值爲 PTHREAD_MUTEX_DEFAULT。

type 參數指定互斥鎖的類型。以下列出了有效的互斥鎖類型:

PTHREAD_MUTEX_NORMAL 描述: 此類型的互斥鎖不會檢測死鎖。如果線程在不首先解除互斥鎖的情況下嘗試重新鎖定該互斥鎖,則會產生死鎖。嘗試解除由其他線程鎖定的互斥鎖會產生不確定的行爲。如果嘗試解除鎖定的互斥鎖未鎖定,則會產生不確定的行爲。 PTHREAD_MUTEX_ERRORCHECK 描述: 此類型的互斥鎖可提供錯誤檢查。如果線程在不首先解除鎖定互斥鎖的情況下嘗試重新鎖定該互斥鎖,則會返回錯誤。如果線程嘗試解除鎖定的互斥鎖已經由其他線程鎖定,則會返回錯誤。如果線程嘗試解除鎖定的互斥鎖未鎖定,則會返回錯誤。 PTHREAD_MUTEX_RECURSIVE 描述: 如果線程在不首先解除鎖定互斥鎖的情況下嘗試重新鎖定該互斥鎖,則可成功鎖定該互斥鎖。 與 PTHREAD_MUTEX_NORMAL 類型的互斥鎖不同,對此類型互斥鎖進行重新鎖定時不會產生死鎖情況。多次鎖定互斥鎖需要進行相同次數的解除鎖定纔可以釋放該鎖,然後其他線程才能獲取該互斥鎖。如果線程嘗試解除鎖定的互斥鎖已經由其他線程鎖定,則會返回錯誤。 如果線程嘗試解除鎖定的互斥鎖未鎖定,則會返回錯誤。 PTHREAD_MUTEX_DEFAULT 描述: 如果嘗試以遞歸方式鎖定此類型的互斥鎖,則會產生不確定的行爲。對於不是由調用線程鎖定的此類型互斥鎖,如果嘗試對它解除鎖定,則會產生不確定的行爲。對於尚未鎖定的此類型互斥鎖,如果嘗試對它解除鎖定,也會產生不確定的行爲。允許在實現中將該互斥鎖映射到其他互斥鎖類型之一。對於 Solaris 線程,PTHREAD_PROCESS_DEFAULT 會映射到 PTHREAD_PROCESS_NORMAL。

pthread_mutexattr_settype 返回值
如果運行成功,pthread_mutexattr_settype 函數會返回零。否則,將返回用於指明錯誤的錯誤號。

EINVAL 描述: 值爲 type 無效。EINVAL 描述: attr 指定的值無效。

編輯本段獲取互斥鎖的類型屬性

pthread_mutexattr_gettype(3C) 可用來獲取由 pthread_mutexattr_settype() 設置的互斥鎖的 type 屬性。
pthread_mutexattr_gettype 語法
#include <pthread.h> int pthread_mutexattr_gettype(pthread_mutexattr_t *attr , int *type); 類型屬性的缺省值爲 PTHREAD_MUTEX_DEFAULT。

type 參數指定互斥鎖的類型。有效的互斥鎖類型包括:

PTHREAD_MUTEX_NORMAL PTHREAD_MUTEX_ERRORCHECK PTHREAD_MUTEX_RECURSIVE PTHREAD_MUTEX_DEFAULT 有關每種類型的說明,請參見pthread_mutexattr_settype 語法。

pthread_mutexattr_gettype 返回值
如果成功完成,pthread_mutexattr_gettype() 會返回 0。其他任何返回值都表示出現了錯誤。

編輯本段設置互斥鎖屬性的協議

pthread_mutexattr_setprotocol(3C) 可用來設置互斥鎖屬性對象的協議屬性。
pthread_mutexattr_setprotocol 語法
#include <pthread.h> int pthread_mutexattr_setprotocol(pthread_mutexattr_t *attr, int protocol); attr 指示以前調用 pthread_mutexattr_init() 時創建的互斥鎖屬性對象。

protocol 可定義應用於互斥鎖屬性對象的協議。

pthread.h 中定義的 protocol 可以是以下值之一:PTHREAD_PRIO_NONE、PTHREAD_PRIO_INHERIT 或 PTHREAD_PRIO_PROTECT。

PTHREAD_PRIO_NONE 線程的優先級和調度不會受到互斥鎖擁有權的影響。PTHREAD_PRIO_INHERIT 此協議值(如 thrd1)會影響線程的優先級和調度。如果更高優先級的線程因 thrd1 所擁有的一個或多個互斥鎖而被阻塞,而這些互斥鎖是用 PTHREAD_PRIO_INHERIT 初始化的,則 thrd1 將以高於它的優先級或者所有正在等待這些互斥鎖(這些互斥鎖是 thrd1 指所擁有的互斥鎖)的線程的最高優先級運行。如果 thrd1 因另一個線程 (thrd3) 擁有的互斥鎖而被阻塞,則相同的優先級繼承效應會以遞歸方式傳播給 thrd3。使用 PTHREAD_PRIO_INHERIT 可以避免優先級倒置。低優先級的線程持有較高優先級線程所需的鎖時,便會發生優先級倒置。只有在較低優先級的線程釋放該鎖之後,較高優先級的線程才能繼續使用該鎖。設置 PTHREAD_PRIO_INHERIT,以便按與預期的優先級相反的優先級處理每個線程。如果爲使用協議屬性值 PTHREAD_PRIO_INHERIT 初始化的互斥鎖定義了 _POSIX_THREAD_PRIO_INHERIT,則互斥鎖的屬主失敗時會執行以下操作。屬主失敗時的行爲取決於 pthread_mutexattr_setrobust_np() 的 robustness 參數的值。解除鎖定互斥鎖。互斥鎖的下一個屬主將獲取該互斥鎖,並返回錯誤 EOWNERDEAD。互斥鎖的下一個屬主會嘗試使該互斥鎖所保護的狀態一致。如果上一個屬主失敗,則狀態可能會不一致。如果屬主成功使狀態保持一致,則可針對該互斥鎖調用 pthread_mutex_init() 並解除鎖定該互斥鎖。注 – 如果針對以前初始化的但尚未銷燬的互斥鎖調用 pthread_mutex_init(),則該互斥鎖不會重新初始化。如果屬主無法使狀態保持一致,請勿調用 pthread_mutex_init(),而是解除鎖定該互斥鎖。在這種情況下,所有等待的線程都將被喚醒。以後對 pthread_mutex_lock() 的所有調用將無法獲取互斥鎖,並將返回錯誤代碼 ENOTRECOVERABLE。現在,通過調用 pthread_mutex_destroy() 來取消初始化該互斥鎖,即可使其狀態保持一致。調用 pthread_mutex_init() 可重新初始化互斥鎖。如果已獲取該鎖的線程失敗並返回 EOWNERDEAD,則下一個屬主將獲取該鎖及錯誤代碼 EOWNERDEAD。PTHREAD_PRIO_PROTECT 當線程擁有一個或多個使用 PTHREAD_PRIO_PROTECT 初始化的互斥鎖時,此協議值會影響其他線程(如 thrd2)的優先級和調度。thrd2 以其較高的優先級或者以 thrd2 擁有的所有互斥鎖的最高優先級上限運行。基於被 thrd2 擁有的任一互斥鎖阻塞的較高優先級線程對於 thrd2 的調度沒有任何影響。 如果某個線程調用 sched_setparam() 來更改初始優先級,則調度程序不會採用新優先級將該線程移到調度隊列末尾。

線程擁有使用 PTHREAD_PRIO_INHERIT 或 PTHREAD_PRIO_PROTECT 初始化的互斥鎖線程解除鎖定使用 PTHREAD_PRIO_INHERIT 或 PTHREAD_PRIO_PROTECT 初始化的互斥鎖 一個線程可以同時擁有多個混合使用 PTHREAD_PRIO_INHERIT 和 PTHREAD_PRIO_PROTECT 初始化的互斥鎖。在這種情況下,該線程將以通過其中任一協議獲取的最高優先級執行。

pthread_mutexattr_setprotocol 返回值
如果成功完成,pthread_mutexattr_setprotocol() 會返回 0。其他任何返回值都表示出現了錯誤。

如果出現以下任一情況,pthread_mutexattr_setprotocol() 將失敗並返回對應的值。

ENOSYS 描述: 選項 _POSIX_THREAD_PRIO_INHERIT 和 _POSIX_THREAD_PRIO_PROTECT 均未定義並且該實現不支持此函數。 ENOTSUP 描述: protocol 指定的值不受支持。 如果出現以下任一情況,pthread_mutexattr_setprotocol() 可能會失敗並返回對應的值。

EINVAL 描述: attr 或 protocol 指定的值無效。EPERM 描述: 調用方無權執行該操作。

獲取互斥鎖屬性的協議

pthread_mutexattr_getprotocol(3C) 可用來獲取互斥鎖屬性對象的協議屬性。
pthread_mutexattr_getprotocol 語法
#include <pthread.h> int pthread_mutexattr_getprotocol(const pthread_mutexattr_t *attr, int *protocol); attr 指示以前調用 pthread_mutexattr_init() 時創建的互斥鎖屬性對象。

protocol 包含以下協議屬性之一:PTHREAD_PRIO_NONE、PTHREAD_PRIO_INHERIT 或 PTHREAD_PRIO_PROTECT。

pthread_mutexattr_getprotocol 返回值
如果成功完成,pthread_mutexattr_getprotocol() 會返回 0。其他任何返回值都表示出現了錯誤。

如果出現以下情況,pthread_mutexattr_getprotocol() 將失敗並返回對應的值。

ENOSYS 描述: _POSIX_THREAD_PRIO_INHERIT 選項和 _POSIX_THREAD_PRIO_PROTECT 選項均未定義並且該實現不支持此函數。 如果出現以下任一情況,pthread_mutexattr_getprotocol() 可能會失敗並返回對應的值。

EINVAL 描述: attr 指定的值無效。EPERM 描述: 調用方無權執行該操作。

設置互斥鎖屬性的優先級上限

pthread_mutexattr_setprioceiling(3C) 可用來設置互斥鎖屬性對象的優先級上限屬性。
pthread_mutexattr_setprioceiling 語法
#include <pthread.h> int pthread_mutexattr_setprioceiling(pthread_mutexatt_t *attr, int prioceiling, int *oldceiling); attr 指示以前調用 pthread_mutexattr_init() 時創建的互斥鎖屬性對象。

prioceiling 指定已初始化互斥鎖的優先級上限。優先級上限定義執行互斥鎖保護的臨界段時的最低優先級。prioceiling 位於 SCHED_FIFO 所定義的優先級的最大範圍內。要避免優先級倒置,請將 prioceiling 設置爲高於或等於可能會鎖定特定互斥鎖的所有線程的最高優先級。

oldceiling 包含以前的優先級上限值。

pthread_mutexattr_setprioceiling 返回值
如果成功完成,pthread_mutexattr_setprioceiling() 會返回 0。其他任何返回值都表示出現了錯誤。

如果出現以下任一情況,pthread_mutexattr_setprioceiling() 將失敗並返回對應的值。

ENOSYS 描述: 選項 _POSIX_THREAD_PRIO_PROTECT 未定義並且該實現不支持此函數。 如果出現以下任一情況,pthread_mutexattr_setprioceiling() 可能會失敗並返回對應的值。

EINVAL 描述: attr 或 prioceiling 指定的值無效。EPERM 描述: 調用方無權執行該操作。

獲取互斥鎖屬性的優先級上限

pthread_mutexattr_getprioceiling(3C) 可用來獲取互斥鎖屬性對象的優先級上限屬性。
pthread_mutexattr_getprioceiling 語法
#include <pthread.h> int pthread_mutexattr_getprioceiling(const pthread_mutexatt_t *attr, int *prioceiling); attr 指定以前調用 pthread_mutexattr_init() 時創建的屬性對象。

注 –

僅當定義了 _POSIX_THREAD_PRIO_PROTECT 符號時,attr 互斥鎖屬性對象纔會包括優先級上限屬性。

pthread_mutexattr_getprioceiling() 返回 prioceiling 中已初始化互斥鎖的優先級上限。優先級上限定義執行互斥鎖保護的臨界段時的最低優先級。prioceiling 位於 SCHED_FIFO 所定義的優先級的最大範圍內。要避免優先級倒置,請將 prioceiling 設置爲高於或等於可能會鎖定特定互斥鎖的所有線程的最高優先級。

pthread_mutexattr_getprioceiling 返回值
如果成功完成,pthread_mutexattr_getprioceiling() 會返回 0。其他任何返回值都表示出現了錯誤。

如果出現以下任一情況,pthread_mutexattr_getprioceiling() 將失敗並返回對應的值。

ENOSYS 描述: _POSIX_THREAD_PRIO_PROTECT 選項未定義並且該實現不支持此函數。 如果出現以下任一情況,pthread_mutexattr_getprioceiling() 可能會失敗並返回對應的值。

EINVAL 描述: attr 指定的值無效。EPERM 描述: 調用方無權執行該操作。

設置互斥鎖的優先級上限

pthread_mutexattr_setprioceiling(3C) 可用來設置互斥鎖的優先級上限。
pthread_mutex_setprioceiling 語法
#include <pthread.h> int pthread_mutex_setprioceiling(pthread_mutex_t *mutex, int prioceiling, int *old_ceiling); pthread_mutex_setprioceiling() 可更改互斥鎖 mutex 的優先級上限 prioceiling。 pthread_mutex_setprioceiling() 可鎖定互斥鎖(如果未鎖定的話),或者一直處於阻塞狀態,直到 pthread_mutex_setprioceiling() 成功鎖定該互斥鎖,更改該互斥鎖的優先級上限並將該互斥鎖釋放爲止。鎖定互斥鎖的過程無需遵循優先級保護協議。

如果 pthread_mutex_setprioceiling() 成功,則將在 old_ceiling 中返回以前的優先級上限值。如果 pthread_mutex_setprioceiling() 失敗,則互斥鎖的優先級上限保持不變。

pthread_mutex_setprioceiling 返回值
如果成功完成,pthread_mutex_setprioceiling() 會返回 0。其他任何返回值都表示出現了錯誤。

如果出現以下情況,pthread_mutexatt_setprioceiling() 將失敗並返回對應的值。

ENOSYS 描述: 選項_POSIX_THREAD_PRIO_PROTECT 未定義並且該實現不支持此函數。 如果出現以下任一情況,pthread_mutex_setprioceiling() 可能會失敗並返回對應的值。

EINVAL 描述: prioceiling 所請求的優先級超出了範圍。EINVAL 描述: mutex 指定的值不會引用當前存在的互斥鎖。ENOSYS 描述: 該實現不支持互斥鎖的優先級上限協議。EPERM 描述: 調用方無權執行該操作。

獲取互斥鎖的優先級上限

pthread_mutexattr_getprioceiling(3C) 可用來獲取互斥鎖的優先級上限。
pthread_mutex_getprioceiling 語法
#include <pthread.h> int pthread_mutex_getprioceiling(const pthread_mutex_t *mutex, int *prioceiling); pthread_mutex_getprioceiling() 會返回 mutex 的優先級上限 prioceiling。
pthread_mutex_getprioceiling 返回值
如果成功完成,pthread_mutex_getprioceiling() 會返回 0。其他任何返回值都表示出現了錯誤。

如果出現以下任一情況,pthread_mutexatt_getprioceiling() 將失敗並返回對應的值。

ENOSYS 描述: _POSIX_THREAD_PRIO_PROTECT 選項未定義並且該實現不支持此函數。 如果出現以下任一情況,pthread_mutex_getprioceiling() 可能會失敗並返回對應的值。

EINVAL 描述: mutex 指定的值不會引用當前存在的互斥鎖。ENOSYS 描述: 該實現不支持互斥鎖的優先級上限協議。EPERM 描述: 調用方無權執行該操作。

設置互斥鎖的強健屬性

pthread_mutexattr_setrobust_np(3C) 可用來設置互斥鎖屬性對象的強健屬性。
pthread_mutexattr_setrobust_np 語法
#include <pthread.h> int pthread_mutexattr_setrobust_np(pthread_mutexattr_t *attr, int *robustness); 注 –

僅當定義了符號 _POSIX_THREAD_PRIO_INHERIT 時,pthread_mutexattr_setrobust_np() 才適用。

attr 指示以前通過調用 pthread_mutexattr_init() 創建的互斥鎖屬性對象。

robustness 定義在互斥鎖的屬主失敗時的行爲。pthread.h 中定義的 robustness 的值爲 PTHREAD_MUTEX_ROBUST_NP 或 PTHREAD_MUTEX_STALLED_NP。缺省值爲 PTHREAD_MUTEX_STALLED_NP。

PTHREAD_MUTEX_ROBUST_NP 如果互斥鎖的屬主失敗,則以後對 pthread_mutex_lock() 的所有調用將以不確定的方式被阻塞。 PTHREAD_MUTEX_STALLED_NP 互斥鎖的屬主失敗時,將會解除鎖定該互斥鎖。互斥鎖的下一個屬主將獲取該互斥鎖,並返回錯誤 EOWNWERDEAD。 注 – 應用程序必須檢查 pthread_mutex_lock() 的返回代碼,查找返回錯誤 EOWNWERDEAD 的互斥鎖。互斥鎖的新屬主應使該互斥鎖所保護的狀態保持一致。如果上一個屬主失敗,則互斥鎖狀態可能會不一致。 如果新屬主能夠使狀態保持一致,請針對該互斥鎖調用 pthread_mutex_consistent_np(),並解除鎖定該互斥鎖。 如果新屬主無法使狀態保持一致,請勿針對該互斥鎖調用 pthread_mutex_consistent_np(),而是解除鎖定該互斥鎖。 所有等待的線程都將被喚醒,以後對 pthread_mutex_lock() 的所有調用都將無法獲取該互斥鎖。返回代碼爲 ENOTRECOVERABLE。通過調用 pthread_mutex_destroy() 取消對互斥鎖的初始化,並調用 pthread_mutex_int() 重新初始化該互斥鎖,可使該互斥鎖保持一致。如果已獲取該鎖的線程失敗並返回 EOWNERDEAD,則下一個屬主獲取該鎖時將返回代碼 EOWNERDEAD。

pthread_mutexattr_setrobust_np 返回值
如果成功完成,pthread_mutexattr_setrobust_np() 會返回 0。其他任何返回值都表示出現了錯誤。

如果出現以下任一情況,pthread_mutexattr_setrobust_np() 將失敗並返回對應的值。

ENOSYS 描述: 選項 _POSIX_THREAD_PRIO__INHERIT 未定義,或者該實現不支持 pthread_mutexattr_setrobust_np()。 ENOTSUP 描述: robustness 指定的值不受支持。 pthread_mutexattr_setrobust_np() 可能會在出現以下情況時失敗:

EINVAL 描述: attr 或 robustness 指定的值無效。

獲取互斥鎖的強健屬性

pthread_mutexattr_getrobust_np(3C) 可用來獲取互斥鎖屬性對象的強健屬性。
pthread_mutexattr_getrobust_np 語法
#include <pthread.h> int pthread_mutexattr_getrobust_np(const pthread_mutexattr_t *attr, int *robustness); 注 –

僅當定義了符號 _POSIX_THREAD_PRIO_INHERIT 時,pthread_mutexattr_getrobust_np() 才適用。

attr 指示以前通過調用 pthread_mutexattr_init() 創建的互斥鎖屬性對象。

robustness 是互斥鎖屬性對象的強健屬性值。

pthread_mutexattr_getrobust_np 返回值
如果成功完成,pthread_mutexattr_getrobust_np() 會返回 0。其他任何返回值都表示出現了錯誤。

如果出現以下任一情況,pthread_mutexattr_getrobust_np() 將失敗並返回對應的值。

ENOSYS 描述: 選項 _POSIX_THREAD_PRIO__INHERIT 未定義,或者該實現不支持 pthread_mutexattr_getrobust_np()。 pthread_mutexattr_getrobust_np() 可能會在出現以下情況時失敗:

EINVAL 描述: attr 或 robustness 指定的值無效。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章