NAME

    pthread_detach - Marks a thread object for deletion

 SYNOPSIS

     #include <pthread.h>

     int pthread_detach( pthread_t *thread );

 PARAMETERS

     thread                Thread object marked for deletion.

 DESCRIPTION

 The pthread_detach() routine indicates that storage for the specified
 thread is reclaimed when the thread terminates. This includes storage
 for the thread parameter's return value. If thread has not terminated
 when this routine is called, this routine does not cause it to ter-
 minate.

 Call this routine when a thread object is no longer referenced.  Addi-
 tionally, call this routine for every thread that is created to ensure
 that storage for thread objects does not accumulate.

 You cannot join with a thread after the thread has been detached.
 The results of this routine are unpredictable if the value of thread
 refers to a thread object that does not exist.

 RETURN VALUES

 If the function fails, errno may be set to one of the following values:

    Return   Error      Description
    _____________________________________________________________
     0                  Successful completion.

    -1      [EINVAL]    The value specified by thread is invalid.

    -1      [ESRCH]     The value specified by thread does not
                        refer to an existing thread.

 RELATED INFORMATION

     FUNCTIONS:  pthread_cancel
                 pthread_create
                 pthread_exit
                 pthread_join