PTHREAD_MUTEXATTR(3)

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);

DESCRIPTION

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.