HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

pthread_detach(3T) pthread_detach(3T)

(Pthread Library)

NAME

pthread_detach() - mark a thread as detached to reclaim its resources when it terminates

SYNOPSIS

#include <pthread.h>

int pthread_detach(

pthread_t thread

);

PARAMETERS

thread Thread whose resources are to be reclaimed immediately when it terminates.

DESCRIPTION

pthread_detach()

is used to detach the thread thread. When thread terminates, its resources will

automatically be reclaimed by the system. If thread has already terminated,

pthread_detach()

causes the resources of thread to be reclaimed by the system.

pthread_detach()

does not cause thread to terminate.

Once a detached thread has terminated, its resources, including the thread ID, may be reused by the sys-

tem. The return status of a detached thread is lost when the thread terminates.

Calling this function multiple times for the same thread results in undeﬁned behavior.

RETURN VALUE

Upon successful completion,

pthread_detach()

returns zero. Otherwise, an error number is returned

to indicate the error (the

errno variable is not set).

ERRORS

If any of the following occur, the

pthread_detach()

function returns the corresponding error number:

[EINVAL] thread does not refer to a joinable thread.

[ESRCH] No thread could be found corresponding to thread.

AUTHOR

pthread_detach() was derived from the IEEE POSIX P1003.1c standard.