pthread_attr_setdetachstate(3) [osf1 man page]

pthread_attr_setdetachstate(3)				     Library Functions Manual				    pthread_attr_setdetachstate(3)

NAME

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

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int pthread_attr_setdetachstate(
			  pthread_attr_t  *attr,
			  int		  detachstate);

STANDARDS

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

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

PARAMETERS

       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

       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:
       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

       None

RELATED INFORMATION

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

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

														    pthread_attr_setdetachstate(3)

Check Out this Related Man Page

pthread_attr_getdetachstate(3C) 			   Standard C Library Functions 			   pthread_attr_getdetachstate(3C)

NAME

       pthread_attr_getdetachstate, pthread_attr_setdetachstate - get or set detachstate attribute

SYNOPSIS

       cc -mt [ flag... ] file... -lpthread [ library... ]
       #include <pthread.h>

       int pthread_attr_setdetachstate(pthread_attr_t *attr,
	    int detachstate);

       int pthread_attr_getdetachstate(const pthread_attr_t *attr,
	    int *detachstate);

DESCRIPTION

       The  detachstate  attribute  controls whether the thread is created in a detached state. If the thread is created detached, then use of the
       ID of the newly created thread by the pthread_detach() or pthread_join() function is an error.

       The pthread_attr_setdetachstate() and pthread_attr_getdetachstate(), respectively, set and  get	the  detachstate  attribute  in  the  attr
       object.

       The  detachstate  can be set to either  PTHREAD_CREATE_DETACHED or  PTHREAD_CREATE_JOINABLE. A value of	PTHREAD_CREATE_DETACHED causes all
       threads created with attr to be in the detached state, whereas using a value of PTHREAD_CREATE_JOINABLE causes  all  threads  created  with
       attr to be in the joinable state. The default value of the detachstate attribute is PTHREAD_CREATE_JOINABLE.

RETURN VALUES

       Upon  successful completion, pthread_attr_setdetachstate() and pthread_attr_getdetachstate() return a value of  0. Otherwise, an error num-
       ber is returned to indicate the error.

       The pthread_attr_getdetachstate() function stores the value of the detachstate attribute in detachstate if successful.

ERRORS

       The pthread_attr_setdetachstate() or pthread_attr_getdetachstate() functions may fail if:

       EINVAL	 attr or detachstate is invalid.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       pthread_attr_init(3C), pthread_attr_setstackaddr(3C), pthread_attr_setstacksize(3C), pthread_create(3C), attributes(5), standards(5)

SunOS 5.11							    23 Mar 2005 				   pthread_attr_getdetachstate(3C)

Linux and UNIX Man Pages

pthread_attr_setdetachstate(3) [osf1 man page]

Check Out this Related Man Page