listing for P
pthread_attr_setdetachstate - Changes the detachstate attribute in the
specified thread attributes object
int detachstate );
DECthreads POSIX 1003.1c Library (libpthread.so)
Interfaces documented on this reference page conform to industry standards
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
Thread attributes object to be modified.
New value for the detachstate attribute. Valid values are as follows:
This the default value. Threads are created in "undetached"
The created thread is detached immediately, before it begins
This routine changes the detachstate attribute in the thread attributes
object specified by the attr argument. The detachstate attribute specifies
whether the thread created using the specified thread attributes object is
created in a detached state or not. A value of PTHREAD_CREATE_JOINABLE
indicates the thread is not detached, and a value of
PTHREAD_CREATE_DETACHED indicates the thread is detached.
PTHREAD_CREATE_JOINABLE is the default value.
Your program cannot use the thread handle (the value of type pthread_t that
is returned by the pthread_create(3) routine) for a detached thread because
the thread might terminate asynchronously, and a thread ID is not valid
after termination. In particular, it is an error to attempt to detach or
join with a detached thread.
When a thread that has not been detached completes execution, DECthreads
retains the state of that thread to allow another thread to join with it.
If the thread is detached before it completes execution, DECthreads is free
to immediately reclaim the thread's storage and resources. Failing to
detach threads that have completed execution can result in wasting
resources, so threads should be detached as soon as the program is done
with them. If there is no need to use the thread's handle after creation,
create the thread initially detached.
If an error condition occurs, this routine returns an integer value
indicating the type of error. Possible return values are as follows:
0 Successful completion. The detached state attribute is returned in
The value specified by the attr argument is not a valid thread
attributes object or the detachstate argument is invalid.
Functions: pthread_attr_init(3), pthread_attr_getdetachstate(3),
Manuals: Guide to DECthreads and Programmer's Guide
listing for P