NAME    [Toc]    [Back]

       pthread_detach - Marks a thread object for deletion

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_detach(
               pthread_t thread );

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

DESCRIPTION    [Toc]    [Back]

       This routine marks the specified thread object to indicate
       that storage for the corresponding thread can be reclaimed
       when  the thread terminates. 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    [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
       value  specified  by  thread  does not refer to a joinable
       thread.  The value specified by thread cannot be found.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

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

       Manuals: Guide to DECthreads and Programmer's Guide



                                                pthread_detach(3)