.\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH PTHREAD_MUTEXATTR 3 LinuxThreads .SH NOM pthread_mutexattr_init, pthread_mutexattr_destroy, pthread_mutexattr_settype, pthread_mutexattr_gettype \- Attributs de création de mutex .SH SYNOPSIS \fB#include \fP \fBint pthread_mutexattr_init(pthread_mutexattr_t *\fP\fIattr\fP\fB);\fP \fBint pthread_mutexattr_destroy(pthread_mutexattr_t *\fP\fIattr\fP\fB);\fP \fBint pthread_mutexattr_settype(pthread_mutexattr_t *\fP\fIattr\fP\fB, int \fP\fIkind\fP\fB);\fP \fBint pthread_mutexattr_gettype(const pthread_mutexattr_t *\fP\fIattr\fP\fB, int *\fP\fIkind\fP\fB);\fP .SH 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 à \fBpthread_mutex_init\fP(3). Passer une valeur \fBNULL\fP est équivalent à un objet attributs de mutex avec tous les attributs positionnés à leur valeur par défaut. \fBpthread_mutexattr_init\fP() initialise l'objet attributs de mutex \fIattr\fP et le remplit avec les valeurs par défaut. \fBpthread_mutexattr_destroy\fP() détruit un objet attributs de mutex qui ne doit plus jamais être utilisé à moins d'être réinitialisé. \fBpthread_mutexattr_destroy\fP() ne fait rien dans l'implémentation LinuxThreads. LinuxThreads supporte seulement un seul attribut de mutex\ : le type de mutex qui peut être soit \fBPTHREAD_MUTEX_FAST_NP\fP pour des mutex «\ rapides\ », soit \fBPTHREAD_MUTEX_RECURSIVE_NP\fP pour des mutex «\ récursifs\ », soit \fBPTHREAD_MUTEX_ERRORCHECK_NP\fP pour des mutex avec «\ vérification d'erreur\ ». Comme le suffixe \fBNP\fP 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 \fBpthread_mutex_lock\fP(3). Si le mutex est de type «\ rapide\ »; \fBpthread_mutex_lock\fP(3) suspend simplement le thread appelant. Si le mutex est de type avec «\ vérification d'erreur\ », \fBpthread_mutex_lock\fP(3) rend la main immédiatement avec le code d'erreur \fBEDEADLK\fP. Si le mutex est de type «\ récursif\ », l'appel à \fBpthread_mutex_lock\fP(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 \fBpthread_mutex_unlock\fP(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 \fBPTHREAD_MUTEX_FAST_NP\fP. \fBpthread_mutexattr_settype\fP() modifie l'attribut type_de_mutex dans \fIattr\fP à la valeur spécifiée par \fIkind\fP. \fBpthread_mutexattr_gettype\fP() récupère la valeur courante de l'attribut type de mutex dans \fIattr\fP et l'enregistre à l'emplacement pointé par \fIkind\fP. .SH "VALEUR RENVOYÉE" \fBpthread_mutexattr_init\fP(), \fBpthread_mutexattr_destroy\fP() et \fBpthread_mutexattr_gettype\fP() renvoient toujours 0. \fBpthread_mutexattr_settype\fP() renvoie 0 en cas de succès et un code d'erreur non nul en cas d'erreur. .SH ERREURS En cas d'erreur, \fBpthread_mutexattr_settype\fP() renvoie le code d'erreur suivant\ : .TP \fBEINVAL\fP \fItype\fP n'est ni \fBPTHREAD_MUTEX_FAST_NP\fP ni \fBPTHREAD_MUTEX_RECURSIVE_NP\fP ni \fBPTHREAD_MUTEX_ERRORCHECK_NP\fP .SH AUTEUR Xavier Leroy .SH "VOIR AUSSI" \fBpthread_mutex_init\fP(3), \fBpthread_mutex_lock\fP(3), \fBpthread_mutex_unlock\fP(3). .SH TRADUCTION Cette page de manuel a été traduite par Thierry Vignaud en 2000 et révisée par Alain Portal en 2006. La version présente dans Debian est maintenue par les membres de la liste . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages\-fr\-extra.