NOM
pthread_mutexattr_init, pthread_mutexattr_destroy,
pthread_mutexattr_settype, pthread_mutexattr_gettype - Attributs de
création de mutex
SYNOPSIS
#include <pthread.h>
int pthread_mutexattr_init(pthread_mutexattr_t *attr);
int pthread_mutexattr_destroy(pthread_mutexattr_t *attr);
int pthread_mutexattr_settype(pthread_mutexattr_t *attr, int kind);
int pthread_mutexattr_gettype(const pthread_mutexattr_t *attr, int
*kind);
Les attributs de création de mutex peuvent être spécifiés lors de leur
création en les passant en tant que second argument à
pthread_mutex_init(3). Passer une valeur NULL est équivalent à un objet
attributs de mutex avec tous les attributs positionnés à leur valeur
par défaut.
pthread_mutexattr_init() initialise l’objet attributs de mutex attr et
le remplit avec les valeurs par défaut.
pthread_mutexattr_destroy() détruit un objet attributs de mutex qui ne
doit plus jamais être utilisé à moins d’être réinitialisé.
pthread_mutexattr_destroy() ne fait rien dans l’implémentation
LinuxThreads.
LinuxThreads supporte seulement un seul attribut de mutex : le type de
mutex qui peut être soit PTHREAD_MUTEX_FAST_NP pour des mutex
« rapides», soit PTHREAD_MUTEX_RECURSIVE_NP pour des mutex
« récursifs », soit PTHREAD_MUTEX_ERRORCHECK_NP pour des mutex avec
« vérification d’erreur». Comme le suffixe NP l’indique, ce sont des
extensions non portables aux spécifications POSIX et ne devraient donc
jamais être employées dans un programme portable.
Le type de mutex détermine ce qu’il se passe si un thread essaye de
verrouiller un mutex déjà verrouillé par pthread_mutex_lock(3). Si le
mutex est de type « rapide »; pthread_mutex_lock(3) suspend simplement
le thread appelant. Si le mutex est de type avec « vérification
d’erreur», pthread_mutex_lock(3) rend la main immédiatement avec le
code d’erreur EDEADLK. Si le mutex est de type « récursif », l’appel à
pthread_mutex_lock(3) rend la main immédiatement avec un code de retour
de réussite. Le nombre de verrouillage par le thread possédant le mutex
est enregistré dans le mutex. Le thread possédant le mutex doit appeler
pthread_mutex_unlock(3) le même nombre de fois afin que le mutex passe
à l’état déverrouillé.
Le type de mutex par défaut est « rapide », c’est-à-dire
PTHREAD_MUTEX_FAST_NP.
pthread_mutexattr_settype() modifie l’attribut type_de_mutex dans attr
à la valeur spécifiée par kind.
pthread_mutexattr_gettype() récupère la valeur courante de l’attribut
type de mutex dans attr et l’enregistre à l’emplacement pointé par
kind.
VALEUR RENVOYÉE
pthread_mutexattr_init(), pthread_mutexattr_destroy() et
pthread_mutexattr_gettype() renvoient toujours 0.
pthread_mutexattr_settype() renvoie 0 en cas de succès et un code
d’erreur non nul en cas d’erreur.
ERREURS
En cas d’erreur, pthread_mutexattr_settype() renvoie le code d’erreur
suivant :
EINVAL type n’est ni PTHREAD_MUTEX_FAST_NP ni
PTHREAD_MUTEX_RECURSIVE_NP ni PTHREAD_MUTEX_ERRORCHECK_NP
AUTEUR
Xavier Leroy <Xavier.Leroy@inria.fr>
VOIR AUSSI
pthread_mutex_init(3), pthread_mutex_lock(3), pthread_mutex_unlock(3).
TRADUCTION
Cette page de manuel a été traduite par Thierry Vignaud <tvignaud AT
mandriva DOT com> en 2000 et révisée par Alain Portal <aportal AT
univ-montp2 DOT fr> en 2006. La version présente dans Debian est
maintenue par les membres de la liste <debian-l10n-french AT lists DOT
debian DOT org>. Veuillez signaler toute erreur de traduction par un
rapport de bogue sur le paquet manpages-fr-extra.
LinuxThreads