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 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298
|
.TH PTHREAD_ATTR_INIT 3 LinuxThreads
.SH NOM
pthread_attr_init, pthread_attr_destroy, pthread_attr_setdetachstate, pthread_attr_getdetachstate, pthread_attr_setschedparam, pthread_attr_getschedparam, pthread_attr_setschedpolicy, pthread_attr_getschedpolicy, pthread_attr_setinheritsched, pthread_attr_getinheritsched, pthread_attr_setscope, pthread_attr_getscope \- attributs de cration de thread
.SH SYNOPSIS
.B #include <pthread.h>
.BI "int pthread_attr_init(pthread_attr_t *" attr ");"
.BI "int pthread_attr_destroy(pthread_attr_t *" attr ");"
.BI "int pthread_attr_setdetachstate(pthread_attr_t *" attr ", int " detachstate ");"
.BI "int pthread_attr_getdetachstate(const pthread_attr_t *" attr ", int *" detachstate ");"
.BI "int pthread_attr_setschedpolicy(pthread_attr_t *" attr ", int " policy ");"
.BI "int pthread_attr_getschedpolicy(const pthread_attr_t *" attr ", int *" policy ");"
.BI "int pthread_attr_setschedparam(pthread_attr_t *" attr ", const struct sched_param *" param ");"
.BI "int pthread_attr_getschedparam(const pthread_attr_t *" attr ", struct sched_param *" param ");"
.BI "int pthread_attr_setinheritsched(pthread_attr_t *" attr ", int " inherit ");"
.BI "int pthread_attr_getinheritsched(const pthread_attr_t *" attr ", int *" inherit ");"
.BI "int pthread_attr_setscope(pthread_attr_t *" attr ", int " scope ");"
.BI "int pthread_attr_getscope(const pthread_attr_t *" attr ", int *" scope ");"
.SH DESCRIPTION
Modifier les attributs des threads revient remplir la structure des attributs
de threads
.I "attr"
qui est du type
.BR "pthread_attr_t" ,
puis la passer en tant que second argument
.BR "pthread_create" (3).
Un paramtre gal
.B "NULL"
revient choisir les paramtres par dfaut pour tous les attributs.
.B "pthread_attr_init"
initialise la structure d'attributs de thread
.I "attr"
et la remplit avec les valeurs par dfaut pour tous les attributs (ces valeurs
par dfaut sont dfinies plus bas).
Chaque attribut
.I "attrname"
(voir plus bas pour une liste de tous les attributs) peut tre individuellement
modifi en utilisant la fonction
.BI "pthread_attr_set" "attrname"
et rcupr l'aide de la fonction
.BI "pthread_attr_get" "attrname."
.B "pthread_attr_destroy"
dtruit un objet attribut_de_thread, qui ne doit plus jamais tre rutilis
jusqu' ce qu'il soit rinitialis.
.B "pthread_attr_destroy"
ne fait rien dans l'implmentation LinuxThreads.
Les structure d'attributs ne sont consultes que lors de la cration d'un nouveau thread.
La mme structure d'attributs peut tre rutilise pour crer plusieurs
threads. Modifier une structure d'attributs aprs un appel
.B "pthread_create"
ne modifie pas les attributs du thread prcedemment cr.
Les attributs de thread suivants sont supports:
.SS detachstate
Controle si le thread cr est dans l'tat joignable (valeur
.BR "PTHREAD_CREATE_JOINABLE" )
ou dans l'tat dtachable (\fBPTHREAD_CREATE_DETACHED\fP).
Valeur par dfaut:
.BR "PTHREAD_CREATE_JOINABLE" .
Dans l'tat joignable, un autre thread peut se synchroniser avec la fin du
thread et reprendre son excution la fin du thread en utilisant
.BR "pthread_join" (3),
mais certaines ressources du thread resteront alloues aprs sa fin et ne
seront libres que lorsqu'un autre thread appelera
.BR "pthread_join" (3)
sur ce thread.
Dans l'tat dtach, les ressources du thread sont immdiatement libres quand
il se termine, mais
.BR "pthread_join" (3)
ne peut tre utilis pour se synchroniser sur la fin du thread.
Un thread cre dans l'tat joignable peut ensuite tre mis dans l'tat dtach
en utilisant
.BR "pthread_detach" (3).
.SS schedpolicy
change la politique et les paramtres d'ordonnancement pour le thread pour
l'une parmi
.B "SCHED_OTHER"
(processus normal, non temps rl),
.B "SCHED_RR"
(temps rl, round-robin) ou
.B "SCHED_FIFO"
(temps-rl, premier dans la liste, premier excut). Voir
.BR "sched_setpolicy" (2)
pour plus d'information sur ces politiques.
Valeur par dfaut:
.BR "SCHED_OTHER" .
Les politiques d'ordonnancement temps rl
.B "SCHED_RR"
et
.B "SCHED_FIFO"
ne sont disponibles que pour les processus possdant les privilges du
super-utilisateur.
La politique d'ordonnancement d'un thread peut tre modifie aprs sa cration
avec
.BR "pthread_setschedparam" (3).
.SS schedparam
Contient la politique d'ordonnancement (essentiellement, la priorit
d'ordonnancement) pour le thread. Voir
.BR "sched_setparam" (2)
pour plus d'informations sur les paramtres d'ordonnancement.
Valeur par dfaut: priority is 0.
Cet attribute est sans significtion si la politique d'ordonnancement est
.BR "SCHED_OTHER" ;
il n'a d'importance que pour les polices temps-rl
.B "SCHED_RR"
et
.BR "SCHED_FIFO" .
La priorit d'ordonnancement d'un thread peut tre modifie aprs sa cration
avec
.BR "pthread_setschedparam" (3).
.SS inheritsched
Indique si la politique et les paramtres d'ordonnancement pour le nouveau
thread sont dtermins par les valeurs des attributs
.I "schedpolicy"
et
.I "schedparam"
(valeur
.BR "PTHREAD_EXPLICIT_SCHED" )
ou sont hrites du thread parent
(valeur
.BR "PTHREAD_INHERIT_SCHED" ).
Valeur par dfaut:
.BR "PTHREAD_EXPLICIT_SCHED" .
.SS scope
Dfini comment sont interprts les paramtres d'ordonnancement pour le nouveau
thread. Une seule valeur est supporte dans l'implmentation LinuxThreads:
.BR "PTHREAD_SCOPE_SYSTEM" ,
qui signifie que tous les threads sont en comptition avec tous les processus
en cours d'excution pour le temps processeur. En particulier, les priorits de
threads sont interprtes relativement aux priorits de tous les autres
processus sur la machine. L'autre valeur spcifi par le standard,
.BR "PTHREAD_SCOPE_PROCESS" ,
signifie que les threads ne sont en comptition qu'avec les autres threads du
mme processus: les priorits de threads sont interprtes relativement
celles des autres threads du processus, quel que soit la priorit des autres
processus.
.B "PTHREAD_SCOPE_PROCESS"
n'est pas supporte dans LinuxThreads.
Valeur par dfaut:
.BR "PTHREAD_SCOPE_SYSTEM" .
.SH "VALEUR RENVOYE"
Toutes ces fonctions renvoient 0 en cas de succs et un code d'erreur non nul
en cas d'erreur. En cas de succs, les fonctions
.BI "pthread_attr_get" "attrname"
sauvegardent galement la valeur courrante de l'attribut
.I "attrname"
l'emplacement point par leur second argument.
.SH ERREURS
La fonction
.B "pthread_attr_setdetachstate"
renvoie l'un des codes d'erreur suivants en cas de problme:
.RS
.TP
.B "EINVAL"
l'argument
.I "detachstate"
spcifi n'est ni
.B "PTHREAD_CREATE_JOINABLE"
ni
.BR "PTHREAD_CREATE_DETACHED" .
.RE
La fonction
.B "pthread_attr_setschedparam"
renvoie l'un des codes d'erreur suivants en cas de problme:
.RS
.TP
.B "EINVAL"
la priorit indique par
.I "param"
n'est pas dans l'intervalle autoris pour la politique d'ordonnancement
courrante dans
.I "attr"
(1 99 pour
.B "SCHED_FIFO"
et
.BR "SCHED_RR" ;
0 pour
.BR "SCHED_OTHER" ).
.RE
La fonction
.B "pthread_attr_setschedpolicy"
renvoie l'un des codes d'erreur suivants en cas de problme:
.RS
.TP
.B "EINVAL"
l'argument
.I "policy"
spcifi n'est ni
.BR "SCHED_OTHER" ,
ni
.BR "SCHED_FIFO" ,
ni
.BR "SCHED_RR" .
.TP
.B "ENOTSUP"
.I "policy"
est
.B "SCHED_FIFO"
ou
.BR "SCHED_RR" ,
et l'utilisateur effectif du processus appelant n'est pas le super utilisateur.
.RE
La fonction
.B "pthread_attr_setinheritsched"
renvoie l'un des codes d'erreur suivants en cas de problme:
.RS
.TP
.B "EINVAL"
l'argument
.I "inherit"
spcifi n'est ni
.B "PTHREAD_INHERIT_SCHED"
ni
.BR "PTHREAD_EXPLICIT_SCHED" .
.RE
La fonction
.B "pthread_attr_setscope"
renvoie l'un des codes d'erreur suivants en cas de problme:
.RS
.TP
.B "EINVAL"
l'argument
.I "scope"
spcifi n'est ni
.B "PTHREAD_SCOPE_SYSTEM"
ni
.BR "PTHREAD_SCOPE_PROCESS" .
.TP
.B "ENOTSUP"
l'argument
.I "scope"
spcifi est
.B "PTHREAD_SCOPE_PROCESS"
(nnt support).
.RE
.SH AUTEUR
Xavier Leroy <Xavier.Leroy@inria.fr>
.SH TRADUCTION
.RI "Thierry Vignaud <" tvignaud@mandrakesoft.com ">, 2000"
.SH "VOIR AUSSI"
.BR "pthread_create" (3),
.BR "pthread_join" (3),
.BR "pthread_detach" (3),
.BR "pthread_setschedparam" (3).
|