Index Index for
Section 3
Index Alphabetical
listing for P
Bottom of page Bottom of
page		 

pthread_attr_setdetachstate(3)


NAME

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


SYNOPSIS

  #include <pthread.h>

  int pthread_attr_setdetachstate(
	  pthread_attr_t *attr,
	  int detachstate );


LIBRARY

  DECthreads POSIX 1003.1c Library (libpthread.so)


STANDARDS

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

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


PARAMETERS

  attr
      Thread attributes object to be modified.

  detachstate
      New value for the detachstate attribute. Valid values are as follows:

      PTHREAD_CREATE_JOINABLE
	      This the default value. Threads are created in "undetached"
	      state.

      PTHREAD_CREATE_DETACHED
	      The created thread is detached immediately, before it begins
	      running.


DESCRIPTION

  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

  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
      detachstate.

  [EINVAL]
      The value specified by the attr argument is not a valid thread
      attributes object or the detachstate argument is invalid.


ERRORS

  None


SEE ALSO

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

  Manuals: Guide to DECthreads and Programmer's Guide

Index Index for
Section 3
Index Alphabetical
listing for P
Top of page Top of
page