.TH PTHREAD_ATTR_INIT 3 "21 juillet 2003" LinuxThreads "Manuel du programmeur Linux"


.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

Pour modifier les attributs des threads, il faut 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
(voir plus bas).

Chaque attribut 
.I "attrname"
(voir plus bas) 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 structureis 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 supports sont les suivants\ :

.SS detachstate

Indique si le thread est cr dans l'tat joignable (valeur
.BR "PTHREAD_CREATE_JOINABLE" )
ou dans l'tat dtach (\fBPTHREAD_CREATE_DETACHED\fP).

Valeur par dfaut\ : 
.BR "PTHREAD_CREATE_JOINABLE" .

Dans l'tat joignable, un autre thread peut se synchroniser sur la fin du
thread et rsuprer son code de terminaison 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 cr 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-rel),
.B "SCHED_RR"
(temps-rel, round-robin) ou
.B "SCHED_FIFO"
(temps-rel, fifo). Voir
.BR "sched_setpolicy" (2)
pour plus d'informations sur ces politiques.

Valeur par dfaut\ :
.BR "SCHED_OTHER" .

Les politiques d'ordonnancement temps-rel
.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 les paramtres 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: priorit  0.

Cet attribut est sans significtion si la politique  d'ordonnancement est
.BR "SCHED_OTHER" " ;"
il n'a d'importance que pour les ordonnancements temps-rel 
.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 spcifie 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 courante 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
actuellement 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 supe- 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"
(non support).
.RE

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

.SH "VOIR AUSSI"
.BR "pthread_create" (3),
.BR "pthread_join" (3),
.BR "pthread_detach" (3),
.BR "pthread_setschedparam" (3).

.SH TRADUCTION
.RI "Thierry Vignaud <" tvignaud@mandrakesoft.com ">, 2000"
.br
Christophe Blaess, 2003.