summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
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.3thr70
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).