PTHREAD_CREATE

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 11 mars 1998
Index Menu principal

NOM

pthread_create - Créer 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'erreur 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 DOT Leroy AT inria DOT fr>

VOIR AUSSI

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

TRADUCTION

Ce document est une traduction réalisée par Thierry Vignaud <tvignaud AT mandriva DOT com> en 2000 et révisée le 19 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 pthread_create ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 19 novembre 2007