File: pthread_mutexattr_init.3thr

package info (click to toggle)
manpages-fr 0.9.3-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 7,052 kB
  • ctags: 4
  • sloc: makefile: 58; sh: 8
file content (115 lines) | stat: -rw-r--r-- 3,394 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
.TH PTHREAD_MUTEXATTR 3 LinuxThreads


.SH NOM
pthread_mutexattr_init, pthread_mutexattr_destroy, pthread_mutexattr_settype_np, pthread_mutexattr_gettype_np \- attributs de cration de mutex

.SH SYNOPSIS
.B #include <pthread.h>

.BI "int pthread_mutexattr_init(pthread_mutexattr_t *" attr ");"

.BI "int pthread_mutexattr_destroy(pthread_mutexattr_t *" attr ");"

.BI "int pthread_mutexattr_settype_np(pthread_mutexattr_t *" attr ", int " type ");"

.BI "int pthread_mutexattr_gettype_np(const pthread_mutexattr_t *" attr ", int *" type ");"

.SH DESCRIPTION
Les attributs de cration de mutex peuvent tre spcifis lors de leur cration
en les passant en tant que second argument 
.BR "pthread_mutex_init" (3).
.B "NULL"
est quivalent  demander les attributs par dfaut.

.B "pthread_mutexattr_init"
initialisae l'objet attributs_de_mutex
.I "attr"
et le remplit avec les valeurs par dfaut.

.B "pthread_mutexattr_destroy"
dtruit un objeet attributs_de_mutex qui ne doit plus jamais tre utilis.
.B "pthread_mutexattr_destroy"
ne fait rien dans l'implmentation LinuxThreads. 

LinuxThreads supporte seulement un seul attribut de mutex: le type de mutex qui
peut tre soit
.B "PTHREAD_MUTEX_FAST_NP"
pour des mutex rapides, soit
.B "PTHREAD_MUTEX_RECURSIVE_NP"
pour des mutex rcursifs, soit
.B "PTHREAD_MUTEX_ERREURCHECK_NP"
pour des mutex avec vrification d'erreur.
Comme le suffixe
.B "NP"
l'inique, ce sont des extensions non-portables aux standard POSIX et ne
devraient donc jamais tre employs dans un programme portable.

Le type de mutex dtermince ce qui se passe si un thread essaye de verrouiller
un mutex dj verrouill par
.BR "pthread_mutex_lock" (3).
Si le mutex est de type rapide;
.BR "pthread_mutex_lock" (3)
suspend simplement le thread appelant. Si le mutex est de type "avec
vrification d'erreur",
.BR "pthread_mutex_lock" (3)
rend la main immdiatement avec le code d'erreur
.BR "EDEADLK" .
Si le mutex est de type rcursif, l'appel 
.BR "pthread_mutex_lock" (3)
rend la main immdiatement avec un code de retour de succs. Le nombre de
verrouillage par le thread possdant le mutex est enregistr dans le mutex. Le
thread possdant le mutex doit appeler
.BR "pthread_mutex_unlock" (3)
le mme nombre de fois afin que le mutex passe  l'tat dverrouill.

Le type de mutex par dfaut est rapide, c'est--dire 
.BR "PTHREAD_MUTEX_FAST_NP" .

.B "pthread_mutexattr_settype_np"
modifie l'attribut type_de_mutex dans
.I "attr"
 la valeur spcifie par
.IR "type" .

.B "pthread_mutexattr_gettype_np"
rcupre la valeur courrante de l'attrubut type_de_mutex dans
.I "attr"
et l'enregistre  l'emplacement point par
.IR "type" .

.SH "VALEUR RENVOYE"
.BR "pthread_mutexattr_init" ,
.B "pthread_mutexattr_destroy"
et
.B "pthread_mutexattr_gettype_np"
retournent toujours 0.

.B "pthread_mutexattr_settype_np"
retournent 0 en cas de succs et un code d'erreur non nul en cas d'erreur.

.SH ERREURS

En cas d'erreur,
.B "pthread_mutexattr_settype_np"
renvoie l'un des codes d'erreur suivant:
.TP
.B "EINVAL"
.I "type"
n'est ni
.B "PTHREAD_MUTEX_FAST_NP"
ni 
.B "PTHREAD_MUTEX_RECURSIVE_NP"
ni 
.B "PTHREAD_MUTEX_ERREURCHECK_NP"

.SH AUTEUR
Xavier Leroy <Xavier.Leroy@inria.fr>

.SH TRADUCTION
.RI "Thierry Vignaud <" tvignaud@mandrakesoft.com ">, 2000"

.SH "VOIR AUSSI"
.BR "pthread_mutex_init" (3),
.BR "pthread_mutex_lock" (3),
.BR "pthread_mutex_unlock" (3).