pthread_detach(3) [osf1 man page]

pthread_detach(3)					     Library Functions Manual						 pthread_detach(3)

NAME

       pthread_detach - Marks a thread object for deletion.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int  pthread_detach(
			   pthread_t	 thread);

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 object being marked for deletion.

DESCRIPTION

       This  routine marks the specified thread object to indicate that storage for the corresponding thread can be reclaimed when the thread ter-
       minates.  This includes storage for the thread argument's return value, as well as the thread object.  If thread has  not  terminated  when
       this routine is called, this routine does not cause it to terminate.

       When a thread object is no longer referenced, call this routine.

       The results of this routine are unpredictable if the value of thread refers to a thread object that does not exist.

       A thread can be created already detached by setting its thread object's detachstate attribute.

       The pthread_join(3) routine also detaches the target thread after pthread_join(3) returns successfully.

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 value specified by thread does not refer to a joinable thread.  The value specified by thread cannot be found.

ERRORS

       None

RELATED INFORMATION

       Routines: pthread_cancel(3), pthread_create(3), pthread_exit(3), pthread_join(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

																 pthread_detach(3)

pthread_join(3C)														  pthread_join(3C)

NAME

       pthread_join - wait for thread termination

SYNOPSIS

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

       int pthread_join(pthread_t thread, void **status);

       The  pthread_join()  function  suspends	processing of the calling thread until the target thread completes. thread must be a member of the
       current process and it cannot be a detached thread. See pthread_create(3C).

       If two or more threads wait for the same thread to complete, all will suspend processing until the thread  has  terminated,  and  then  one
       thread will return successfully and the others will return with an error of ESRCH. The pthread_join() function will not block processing of
       the calling thread if the target thread has already terminated.

       If a pthread_join() call returns successfully with a non-null status argument, the value passed	to  pthread_exit(3C)  by  the  terminating
       thread will be placed in the location referenced by status.

       If  the	pthread_join()	calling  thread  is cancelled, then the target thread will remain joinable by pthread_join(). However, the calling
       thread may set up a cancellation cleanup handler on thread prior to  the  join  call,  which  may  detach  the  target  thread  by  calling
       pthread_detach(3C). See pthread_detach(3C) and pthread_cancel(3C).

       If successful, pthread_join() returns 0. Otherwise, an error number is returned to indicate the error.

       EDEADLK	       A joining deadlock would occur, such as when a thread attempts to wait for itself.

       EINVAL	       The thread corresponding to the given thread ID is a detached thread.

       ESRCH	       No thread could be found corresponding to the given thread ID.

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

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

       pthread_cancel(3C), pthread_create(3C), pthread_detach(3C), pthread_exit(3C), wait(3C), attributes(5), standards(5)

       The pthread_join(3C) function must specify the thread ID for whose termination it will wait.

       Calling	pthread_join()	also  "detaches"  the  thread;	that is, pthread_join() includes the effect of the pthread_detach() function. If a
       thread were to be cancelled when blocked in pthread_join(), an explicit detach would have to be performed in the cancellation cleanup  han-
       dler. The pthread_detach() function exists primarily for this purpose.

								    23 Mar 2005 						  pthread_join(3C)