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.

                                           LinuxThreads                      PTHREAD_MUTEXATTR(3)