diff options
Diffstat (limited to 'src/patchsets/glibc/2.2.5/man/pthread_create.3thr')
-rw-r--r-- | src/patchsets/glibc/2.2.5/man/pthread_create.3thr | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/src/patchsets/glibc/2.2.5/man/pthread_create.3thr b/src/patchsets/glibc/2.2.5/man/pthread_create.3thr new file mode 100644 index 0000000000..0802ecec94 --- /dev/null +++ b/src/patchsets/glibc/2.2.5/man/pthread_create.3thr @@ -0,0 +1,70 @@ +.TH PTHREAD_CREATE 3 LinuxThreads + +.SH NAME +pthread_create \- create a new thread + +.SH SYNOPSIS +.B #include <pthread.h> + +.BI "int pthread_create(pthread_t * " thread ", pthread_attr_t * " attr ", void * (*" start_routine ")(void *), void * " arg ");" + +.SH DESCRIPTION +.B "pthread_create" +creates a new thread of control that executes +concurrently with the calling thread. The new thread applies the +function +.I "start_routine" +passing it +.I "arg" +as first argument. The new +thread terminates either explicitly, by calling +.BR "pthread_exit" (3), +or implicitly, by returning from the +.I "start_routine" +function. The +latter case is equivalent to calling +.BR "pthread_exit" (3) +with the result +returned by +.I "start_routine" +as exit code. + +The +.I "attr" +argument specifies thread attributes to be applied to the +new thread. See +.BR "pthread_attr_init" (3) +for a complete list of thread +attributes. The +.I "attr" +argument can also be +.BR "NULL" , +in which case +default attributes are used: the created thread is joinable (not +detached) and has default (non real-time) scheduling policy. + +.SH "RETURN VALUE" +On success, the identifier of the newly created thread is stored in +the location pointed by the +.I "thread" +argument, and a 0 is returned. On +error, a non-zero error code is returned. + +.SH ERRORS +.TP +.B "EAGAIN" +not enough system resources to create a process for the new thread. +.TP +.B "EAGAIN" +more than +.B "PTHREAD_THREADS_MAX" +threads are already active. + +.SH AUTHOR +Xavier Leroy <Xavier.Leroy@inria.fr> + +.SH "SEE ALSO" +.BR "pthread_exit" (3), +.BR "pthread_join" (3), +.BR "pthread_detach" (3), +.BR "pthread_attr_init" (3). |