PTHREAD_DETACH(3) manual page

From 41f88a82b33cdb357c83b582381232733ed2d039 Mon Sep 17 00:00:00 2001 From: rpj Date: Thu, 5 May 2005 14:18:27 +0000 Subject: '' --- manual/pthread_detach.html | 84 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 manual/pthread_detach.html (limited to 'manual/pthread_detach.html') diff --git a/manual/pthread_detach.html b/manual/pthread_detach.html new file mode 100644 index 0000000..e5b668b --- /dev/null +++ b/manual/pthread_detach.html @@ -0,0 +1,84 @@ + + + + + PTHREAD_DETACH(3) manual page + + + + + + + +

Table of Contents

Name

pthread_detach - put a running thread in the detached state +

Synopsis

#include <pthread.h> +

int pthread_detach(pthread_t th); +

Description

pthread_detach puts the thread th in the detached +state. This guarantees that the memory resources consumed by th +will be freed immediately when th terminates. However, this +prevents other threads from synchronizing on the termination of th +using pthread_join. +

A thread can be created initially in the detached state, using the +detachstate attribute to pthread_create(3) +. In contrast, pthread_detach applies to threads created in +the joinable state, and which need to be put in the detached state +later. +

After pthread_detach completes, subsequent attempts to +perform pthread_join on th will fail. If another thread +is already joining the thread th at the time pthread_detach +is called, pthread_detach does nothing and leaves th in +the joinable state. +

Return Value

On success, 0 is returned. On error, a non-zero error code is +returned. +

Errors

ESRCH +: + No thread could be found corresponding to that specified by th +
+ EINVAL +: + the thread th is already in the detached state +

+Author