pthread_attr_getdetachstate(3) [osf1 man page]

pthread_attr_getdetachstate(3)				     Library Functions Manual				    pthread_attr_getdetachstate(3)

NAME

       pthread_attr_getdetachstate - Obtains the detachstate attribute of the specified thread attributes object.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int pthread_attr_getdetachstate(
			const pthread_attr_t  *attr,
			int		      *detachstate);

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 attributes object whose detachstate attribute is obtained.  Receives the value of the detachstate attribute.

DESCRIPTION

       This  routine  obtains  the detachstate attribute of a thread attributes object. This attribute specifies whether threads created using the
       specified thread attributes object are created in a detached state.

       See the pthread_attr_setdetachstate description for information about the detachstate attribute.

RETURN VALUES

       On successful completion, this routine returns a zero, and the detachstate attribute is set in detachstate. A value of PTHREAD_CREATE_JOIN-
       ABLE indicates the thread is not detached, and a value of PTHREAD_CREATE_DETACHED indicates the thread is detached.

       If  an  error condition occurs, this routine returns an integer value indicating the type of error.  Possible return values are as follows:
       Successful completion.  The detached state attribute is returned in detachstate.  The value specified by attr does not refer to an existing
       thread attributes object.

ERRORS

       None

RELATED INFORMATION

       Functions: pthread_attr_init(3), pthread_attr_setdetachstate(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

														    pthread_attr_getdetachstate(3)

PTHREAD_ATTR(3) 					   BSD Library Functions Manual 					   PTHREAD_ATTR(3)

NAME

     pthread_attr_getdetachstate, pthread_attr_setdetachstate -- thread attribute operations

SYNOPSIS

     #include <pthread.h>

     int
     pthread_attr_getdetachstate(const pthread_attr_t *attr, int *detachstate);

     int
     pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate);

DESCRIPTION

     Thread attributes are used to specify parameters to pthread_create().  One attribute object can be used in multiple calls to
     pthread_create(), with or without modifications between calls.

     One of these thread attributes governs the creation state of the new thread. The new thread can be either created "detached" or "joinable".
     The constants corresponding to these states are PTHREAD_CREATE_DETACHED and PTHREAD_CREATE_JOINABLE respectively.	Creating a "joinable"
     thread allows the user to call pthread_join() and pthread_detach(), with the new thread's ID. A "detached" thread's ID cannot be used with
     pthread_join() and pthread_detach().  The default value for the "detachstate" attribute is PTHREAD_CREATE_JOINABLE.

     The pthread_attr_setdetachstate() function sets the thread's "detachstate" attribute.

     The "detachstate" attribute is set within the attr argument, which can subsequently be used as an argument to pthread_create().

RETURN VALUES

     If successful, these functions return 0.  Otherwise, an error number is returned to indicate the error.  pthread_attr_getdetachstate(), on
     success, will copy the value of the thread's "detachstate" attribute to the location pointed to by the second function parameter.

ERRORS

     pthread_attr_getdetachstate() will fail if:

     [EINVAL]		Invalid value for attr

     pthread_attr_setdetachstate() will fail if:

     [EINVAL]		Invalid value for attr or detachstate.

SEE ALSO

     pthread_create(3), pthread_join(3), pthread_attr_init(3), pthread_detach(3)

STANDARDS

     pthread_attr_setdetachstate(), pthread_attr_getdetachstate() conform to ISO/IEC 9945-1:1996 (``POSIX.1'')

BSD
								 December 31, 2007							       BSD