Index for Section 3

Alphabetical listing for P

Bottom of page

pthread_detach(3)
NAME
  pthread_detach - Marks a thread object for deletion

SYNOPSIS
  #include <pthread.h>

  int pthread_detach(
	  pthread_t thread );

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  IEEE Std 1003.1c-1995, POSIX System Application Program Interface

PARAMETERS
  thread
      Thread 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:

  0   Successful 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

SEE ALSO
  Routines: pthread_cancel(3), pthread_create(3), pthread_exit(3),
  pthread_join(3)

  Manuals: Guide to DECthreads and Programmer's Guide

Index for Section 3

Alphabetical listing for P

Top of page