pthread_create.3thr

Langue: fr

Version: 41305 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NOM

pthread_create - crée un nouveau thread

SYNOPSIS

#include <pthread.h>

int pthread_create(pthread_t * thread, pthread_attr_t * attr, void * (*start_routine)(void *), void * arg);

DESCRIPTION

pthread_create crée un nouveau thread s'exécutant simultanément avec le thread appelant. Le nouveau thread exécute la fonction start_routine en lui passant arg comme premier argument. Le nouveau thread s'achève soit explicitement en appelant pthread_exit(3), ou implicitement lorsque la fonction start_routine s'achève. Ce dernier cas est équivalent à appeler pthread_exit(3) avec la valeur renvoyée par start_routine comme code de sortie.

L'argument attr indique les attributs du nouveau thread. Voir pthread_attr_init(3) pour une liste complète des attributs. L'argument attr peut être NULL, auquel cas, les attributs par défaut sont utilisés : le thread créé est joignable (non détaché) et utilise la politique d'ordonnancement normale (pas temps-réel).

VALEUR RENVOYÉE

En cas de succès, l'identifiant du nouveau thread est stocké à l'emplacement mémoire pointé par l'argument thread, et 0 est renvoyé. En cas d'erreur, un code d'errur non nul est renvoyé.

ERREURS

EAGAIN
pas assez de ressources système pour créer un processus pour le nouveau thread.
EAGAIN
il y a déjà plus de PTHREAD_THREADS_MAX threads actifs.

AUTEUR

Xavier Leroy <Xavier.Leroy@inria.fr>

VOIR AUSSI

pthread_exit(3), pthread_join(3), pthread_detach(3), pthread_attr_init(3).

TRADUCTION

Thierry Vignaud <tvignaud@mandrakesoft.com>, 2000