Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] 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 création de thread [size=18] [b]Résumé[/b] [/size] [b]#include <pthread.h>[/b] [b][i]int pthread_attr_init(pthread_attr_t * attr );[/i][/b] [b][i]int pthread_attr_destroy(pthread_attr_t * attr );[/i][/b] [b][i]int pthread_attr_setdetachstate(pthread_attr_t * attr , int detachstate );[/i][/b] [b][i]int pthread_attr_getdetachstate(const pthread_attr_t * attr , int * detachstate );[/i][/b] [b][i]int pthread_attr_setschedpolicy(pthread_attr_t * attr , int policy );[/i][/b] [b][i]int pthread_attr_getschedpolicy(const pthread_attr_t * attr , int * policy );[/i][/b] [b][i]int pthread_attr_setschedparam(pthread_attr_t * attr , const struct sched_param * param );[/i][/b] [b][i]int pthread_attr_getschedparam(const pthread_attr_t * attr , struct sched_param * param );[/i][/b] [b][i]int pthread_attr_setinheritsched(pthread_attr_t * attr , int inherit );[/i][/b] [b][i]int pthread_attr_getinheritsched(const pthread_attr_t * attr , int * inherit );[/i][/b] [b][i]int pthread_attr_setscope(pthread_attr_t * attr , int scope );[/i][/b] [b][i]int pthread_attr_getscope(const pthread_attr_t * attr , int * scope );[/i][/b] [size=18] [b]Description[/b] [/size] Pour modifier les attributs des threads, il faut remplir la structure des attributs de threads [i]attr[/i] qui est du type [b]pthread_attr_t ,[/b] puis à la passer en tant que second argument à [b]pthread_create (3).[/b] Un paramètre égal à [b]NULL[/b] revient à choisir les paramètres par défaut pour tous les attributs. [b]pthread_attr_init[/b] initialise la structure d'attributs de thread [i]attr[/i] et la remplit avec les valeurs par défaut pour tous les attributs (voir plus bas). Chaque attribut [i]attrname[/i] (voir plus bas) peut être individuellement modifié en utilisant la fonction [b][i]pthread_attr_set attrname[/i][/b] et récupéré à l'aide de la fonction [b][i]pthread_attr_get attrname.[/i][/b] [b]pthread_attr_destroy[/b] détruit un objet attribut_de_thread, qui ne doit plus jamais être réutilisé jusqu'à ce qu'il soit réinitialisé. [b]pthread_attr_destroy[/b] ne fait rien dans l'implémentation LinuxThreads. Les structureis d'attributs ne sont consultées que lors de la création d'un nouveau thread. La même structure d'attributs peut être réutilisée pour créer plusieurs threads. Modifier une structure d'attributs après un appel à [b]pthread_create[/b] ne modifie pas les attributs du thread précedemment créé. Les attributs de thread supportés sont les suivants : [b]Detachstate[/b] Indique si le thread est créé dans l'état joignable (valeur [b]PTHREAD_CREATE_JOINABLE )[/b] ou dans l'état détaché ([b]PTHREAD_CREATE_DETACHED[/b]). Valeur par défaut : [b]PTHREAD_CREATE_JOINABLE .[/b] Dans l'état joignable, un autre thread peut se synchroniser sur la fin du thread et résupérer son code de terminaison en utilisant [b]pthread_join (3),[/b] mais certaines ressources du thread resteront allouées après sa fin et ne seront libérées que lorsqu'un autre thread appelera [b]pthread_join (3)[/b] sur ce thread. Dans l'état détaché, les ressources du thread sont immédiatement libérées quand il se termine, mais [b]pthread_join (3)[/b] 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 détaché en utilisant [b]pthread_detach (3).[/b] [b]Schedpolicy[/b] change la politique et les paramètres d'ordonnancement pour le thread pour l'une parmi [b]SCHED_OTHER[/b] (processus normal, non temps-réel), [b]SCHED_RR[/b] (temps-réel, round-robin) ou [b]SCHED_FIFO[/b] (temps-réel, fifo). Voir [b]sched_setpolicy (2)[/b] pour plus d'informations sur ces politiques. Valeur par défaut : [b]SCHED_OTHER .[/b] Les politiques d'ordonnancement temps-réel [b]SCHED_RR[/b] et [b]SCHED_FIFO[/b] ne sont disponibles que pour les processus possédant les privilèges du super-utilisateur. La politique d'ordonnancement d'un thread peut être modifiée après sa création avec [b]pthread_setschedparam (3).[/b] [b]Schedparam[/b] Contient les paramètres d'ordonnancement (essentiellement, la priorité d'ordonnancement) pour le thread. Voir [b]sched_setparam (2)[/b] pour plus d'informations sur les paramètres d'ordonnancement. Valeur par défaut: priorité à 0. Cet attribut est sans significtion si la politique d'ordonnancement est [b]SCHED_OTHER ;[/b] il n'a d'importance que pour les ordonnancements temps-réel [b]SCHED_RR[/b] et [b]SCHED_FIFO .[/b] La priorité d'ordonnancement d'un thread peut être modifiée après sa création avec [b]pthread_setschedparam (3).[/b] [b]Inheritsched[/b] Indique si la politique et les paramètres d'ordonnancement pour le nouveau thread sont déterminés par les valeurs des attributs [i]schedpolicy[/i] et [i]schedparam[/i] (valeur [b]PTHREAD_EXPLICIT_SCHED )[/b] ou sont héritées du thread parent (valeur [b]PTHREAD_INHERIT_SCHED ).[/b] Valeur par défaut : [b]PTHREAD_EXPLICIT_SCHED .[/b] [b]Scope[/b] Défini comment sont interprétés les paramètres d'ordonnancement pour le nouveau thread. Une seule valeur est supportée dans l'implémentation LinuxThreads : [b]PTHREAD_SCOPE_SYSTEM ,[/b] qui signifie que tous les threads sont en compétition avec tous les processus en cours d'exécution pour le temps processeur. En particulier, les priorités de threads sont interprétées relativement aux priorités de tous les autres processus sur la machine. L'autre valeur spécifiée par le standard, [b]PTHREAD_SCOPE_PROCESS ,[/b] signifie que les threads ne sont en compétition qu'avec les autres threads du même processus : les priorités de threads sont interprétées relativement à celles des autres threads du processus, quel que soit la priorité des autres processus. [b]PTHREAD_SCOPE_PROCESS[/b] n'est pas supportée dans LinuxThreads. Valeur par défaut : [b]PTHREAD_SCOPE_SYSTEM .[/b] [size=18] [b]Valeur renvoyée[/b] [/size] Toutes ces fonctions renvoient 0 en cas de succès et un code d'erreur non nul en cas d'erreur. En cas de succès, les fonctions [b][i]pthread_attr_get attrname[/i][/b] sauvegardent également la valeur courante de l'attribut [i]attrname[/i] à l'emplacement pointé par leur second argument. [size=18] [b]Erreurs[/b] [/size] La fonction [b]pthread_attr_setdetachstate[/b] renvoie l'un des codes d'erreur suivants en cas de problème :[table][row][col]    [/col][col] [b]EINVAL[/b] [table][row][col]    [/col][col]l'argument [i]detachstate[/i] spécifié n'est ni [b]PTHREAD_CREATE_JOINABLE[/b] ni [b]PTHREAD_CREATE_DETACHED .[/b][/col][/row][/table] La fonction [b]pthread_attr_setschedparam[/b] renvoie l'un des codes d'erreur suivants en cas de problème :[table][row][col]    [/col][col][/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]la priorité indiquée par [i]param[/i] n'est pas dans l'intervalle autorisé pour la politique d'ordonnancement actuellement dans [i]attr[/i] (1 à 99 pour [b]SCHED_FIFO[/b] et [b]SCHED_RR ;[/b] 0 pour [b]SCHED_OTHER ).[/b][/col][/row][/table] La fonction [b]pthread_attr_setschedpolicy[/b] renvoie l'un des codes d'erreur suivants en cas de problème :[table][row][col]    [/col][col][/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]l'argument [i]policy[/i] spécifié n'est ni [b]SCHED_OTHER ,[/b] ni [b]SCHED_FIFO ,[/b] ni [b]SCHED_RR .[/b] [/col][/row][/table] [b]ENOTSUP[/b] [i]policy[/i] [table][row][col]    [/col][col]est [b]SCHED_FIFO[/b] ou [b]SCHED_RR ,[/b] et l'utilisateur effectif du processus appelant n'est pas le supe- utilisateur.[/col][/row][/table] La fonction [b]pthread_attr_setinheritsched[/b] renvoie l'un des codes d'erreur suivants en cas de problème :[table][row][col]    [/col][col][/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]l'argument [i]inherit[/i] spécifié n'est ni [b]PTHREAD_INHERIT_SCHED[/b] ni [b]PTHREAD_EXPLICIT_SCHED .[/b][/col][/row][/table] La fonction [b]pthread_attr_setscope[/b] renvoie l'un des codes d'erreur suivants en cas de problème :[table][row][col]    [/col][col][/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]l'argument [i]scope[/i] spécifié n'est ni [b]PTHREAD_SCOPE_SYSTEM[/b] ni [b]PTHREAD_SCOPE_PROCESS .[/b] [/col][/row][/table] [b]ENOTSUP[/b] [table][row][col]    [/col][col]l'argument [i]scope[/i] spécifié est [b]PTHREAD_SCOPE_PROCESS[/b] (non supporté).[/col][/row][/table] [/col][/row][/table] [size=18] [b]Auteur[/b] [/size] Xavier Leroy <Xavier.Leroy@inria.fr> [size=18] [b]Voir aussi[/b] [/size] [b]pthread_create (3),[/b] [b]pthread_join (3),[/b] [b]pthread_detach (3),[/b] [b]pthread_setschedparam (3).[/b] [size=18] [b]Traduction[/b] [/size] [i]Thierry Vignaud < tvignaud@mandrakesoft.com >, 2000[/i] [b][/b] Christophe Blaess, 2003.
Fichier