pthread_detach(3) — Subroutines
Digital
NAME
pthread_detach − Marks a thread object for deletion.
SYNOPSIS
#include <pthread.h>
int pthread_detach(
pthread_t ∗thread );
PARAMETERS
threadThread object marked for deletion.
DESCRIPTION
This 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 terminate.
Call this routine when a thread object is no longer referenced. Additionally, 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 an error condition occurs, this routine returns −1 and sets errno to the corresponding error value. Possible return values are as follows:
| 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
pthread_cancel(3), pthread_create(3), pthread_exit(3), pthread_join(3)