NAME    [Toc]    [Back]

       pthread_attr_setdetachstate   -  Changes  the  detachstate
       attribute in the specified thread attributes object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_attr_setdetachstate(
               pthread_attr_t *attr,
               int detachstate );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program
       Interface

PARAMETERS    [Toc]    [Back]

       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"
  state.   The  created  thread is detached immediately,
 before it begins running.

DESCRIPTION    [Toc]    [Back]

       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.

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  the  type  of  error. Possible
       return values are as follows: Successful  completion.  The
       detached  state attribute is returned in detachstate.  The
       value specified by the attr argument is not a valid thread
       attributes  object or the detachstate argument is invalid.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:  pthread_attr_init(3),  pthread_attr_getdetachstate(3), pthread_create(3), pthread_join(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                   pthread_attr_setdetachstate(3)