PTHREAD_CREATE(3)					     PTHREAD_CREATE(3)



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.


RETURN VALUE
       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>


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



				 LinuxThreads		     PTHREAD_CREATE(3)