pthread_create(3T)pthread_create(3T)NAMEpthread_create() - create a new thread of execution.
SYNOPSISPARAMETERS
thread Pointer to the location where the created thread's ID
is to be returned.
attr Pointer to the thread attributes object describing the
characteristics of the created thread. If the value is
NULL, default attributes will be used.
start_routine
Function to be executed by the newly created thread.
arg Parameter to be passed to the created thread's
start_routine.
DESCRIPTION
The function is used to create a new independent thread within the
calling process. The thread will be created according to the
attributes specified by attr. If attr is NULL, the default attributes
will be used. The values of the attributes in attr describe the char‐
acteristics of the to-be-created thread in detail. Refer to the func‐
tion for a list of the default attribute values. A single attributes
object can be used in multiple calls to the function
When a thread is created with an attributes object, the attributes are,
in effect, copied into the created thread. Consequently, any change to
the attributes object will not affect any previously created threads.
Once all threads needing a specific attributes object have been cre‐
ated, the attributes object is no longer needed and may be destroyed.
When the new thread is created, it will execute which has only one
parameter, arg. If returns, an implicit call to is made. The return
value of is used as the thread's exit status.
The created thread's scheduling policy and priority, contention scope,
detach state, stack size, and stack address are initialized according
to their respective attributes in attr. The thread's signal mask is
inherited from the creating thread. The thread's set of pending sig‐
nals is cleared.
Refer to pthread_exit(3T), pthread_detach(3T), and pthread_join(3T) for
more information on thread termination and synchronizing with termi‐
nated threads.
On success, the ID of the created thread is returned in thread. If
fails, a thread is not created and the contents of thread are unde‐
fined.
Thread IDs are guaranteed to be unique only within a process.
NOTE: If the main thread returns from an implicit call to is made. The
return value of is used as the process' exit status. The main thread
can terminate without causing the process to terminate by calling
Notes
It is unspecified whether joinable threads that have exited but haven't
been joined count against the limit.
RETURN VALUE
Upon successful completion, returns zero. Otherwise, an error number is
returned to indicate the error (the variable is not set).
ERRORS
If any of the following occur, the function returns the corresponding
error number:
attr in an invalid thread attributes object.
The value specified by
thread is invalid.
The necessary resources to create another thread are not avail‐
able,
or the number of threads in the calling process
already equals
The scheduling policy or scheduling attributes specified in
attr are invalid.
The caller does not have the appropriate privileges to create a
thread with
the scheduling policy and parameters specified in
attr.
AUTHOR
was derived from the IEEE POSIX P1003.1c standard.
SEE ALSOpthread_exit(3T), pthread_join(3T), fork(2).
STANDARDS CONFORMANCE
Pthread Library pthread_create(3T)