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

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

If an error condition occurs, this routine returns an integer value indicating the type of error.  Possible return values are as follows:

0Successful completion. 

[EINVAL]The value specified by thread does not refer to a joinable thread. 

[ESRCH]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