Provided by: glibc-doc_2.9-0ubuntu6_all
 

NAME

        pthread_create - create a new thread
 

SYNOPSIS

        #include <pthread.h>
 
        int  pthread_create(pthread_t  *  thread, pthread_attr_t * attr, void *
        (*start_routine)(void *), void * arg);
 

DESCRIPTION

        pthread_create creates a new thread of control  that  executes  concur-
        rently  with  the  calling  thread. The new thread applies the function
        start_routine passing it arg as first argument. The new  thread  termi-
        nates  either explicitly, by calling pthread_exit(3), or implicitly, by
        returning from the start_routine function. The latter case  is  equiva-
        lent  to calling pthread_exit(3) with the result returned by start_rou-
        tine as exit code.
 
        The attr argument specifies thread attributes to be applied to the  new
        thread.   See  pthread_attr_init(3)  for  a  complete  list  of  thread
        attributes. The attr argument can also be NULL, in which  case  default
        attributes  are used: the created thread is joinable (not detached) and
        has default (non real-time) scheduling policy.
        On success, the identifier of the newly created thread is stored in the
        location pointed by the thread argument, and a 0 is returned. On error,
        a non-zero error code is returned.
 

ERRORS

        EAGAIN not enough system resources to create  a  process  for  the  new
               thread.
 
        EAGAIN more than PTHREAD_THREADS_MAX threads are already active.
 

AUTHOR

        Xavier Leroy <Xavier.Leroy@inria.fr>
        pthread_exit(3),           pthread_join(3),          pthread_detach(3),
        pthread_attr_init(3).
 
                                  LinuxThreads                PTHREAD_CREATE(3)