pthread_attr_destroy(3t) [hpux man page]

pthread_attr_init(3T)													     pthread_attr_init(3T)

NAME

       pthread_attr_init(), pthread_attr_destroy() - initialize or destroy a thread attributes object

SYNOPSIS

PARAMETERS

	      attr	Pointer to the thread attributes object to be initialized or destroyed.

DESCRIPTION

       initializes a thread attributes object attr with the default value for all the thread attributes.

       When  a	thread	attributes object is used to create a thread, the values of the individual attributes determine the characteristics of the
       new thread.  Attributes objects act like additional parameters to object creation. A single attributes object can be used in multiple calls
       to

       After  a  thread  attributes  object has been used to initialize one or more threads, any function affecting the attributes object does not
       affect the previously created threads.

       The thread attributes and their default values are:

	      stacksize 	POSIX.1c does not define a default value.  On HP-UX released on PA-RISC platforms, the default is 64K.	 On  HP-UX
				released on Itanium(R)-based platforms, the default is 256K.

	      guardsize 	The default value is bytes.

	      stackaddr 	The default value is NULL.

	      detachstate	The default value is

	      contentionscope	POSIX.1c  does not define a default value.  The default value is set to The scope can also be specified externally
				by using the options listed in the pthread_scope_options(5) manpage.

	      inheritsched	POSIX.1c does not define a default value. On HP-UX, the default value is

	      schedpolicy	POSIX.1c does not define a default value. On HP-UX, the default value is

	      schedparam	POSIX.1c does not define a default value.

	      processor 	The default value is

	      binding_type	The default value is

       If an initialized thread attributes object is reinitialized, the initialization results in undefined behavior.

       destroys the thread attributes object attr.  The destroyed thread attributes object ceases to exist and its resources are reclaimed. Refer-
       encing  the  object  after  it has been destroyed results in undefined behavior.  A destroyed thread attributes object can be reinitialized
       using thread attribute initialization routine

       Threads that have already been created using this attributes object are not affected by the destruction of the thread attributes object.

RETURN VALUE

       Upon successful completion, and return zero.  Otherwise, an error number is returned to indicate the error (the variable is not set).

ERRORS

       If any of the following occur, the function returns the corresponding error number:

	      [ENOMEM]	     There is insufficient memory available in which to initialize the pthread attributes object.

	      [EINVAL]	     The value specified by attr is invalid.

       If any of the following occur, the function returns the corresponding error number:

	      [EINVAL]	     The value specified by attr is invalid.

AUTHOR

       and were derived from the IEEE POSIX P1003.1c standard.

SEE ALSO

       pthread_create(3T).

STANDARDS CONFORMANCE

								  Pthread Library					     pthread_attr_init(3T)

pthread_attr_init(3C)					   Standard C Library Functions 				     pthread_attr_init(3C)

NAME

       pthread_attr_init, pthread_attr_destroy - initialize or destroy threads attribute object

SYNOPSIS

       cc -mt [ flag... ] file... -lpthread [ library... ]
       #include <pthread.h>

       int pthread_attr_init(pthread_attr_t *attr);

       int pthread_attr_destroy(pthread_attr_t *attr);

DESCRIPTION

       The  function  pthread_attr_init()  initializes a thread attributes object attr with the default value for all of the individual attributes
       used by a given implementation.

       The resulting attribute object (possibly modified by setting individual attribute values),  when  used  by  pthread_create(),  defines  the
       attributes of the thread created. A single attributes object can be used in multiple simultaneous calls to pthread_create().

       The pthread_attr_init() function initializes a thread attributes object ( attr) with the default value for each attribute as follows:

	   Attribute		 Default Value		      Meaning of Default
       -----------------------------------------------------------------------------------
       contentionscope	    PTHREAD_SCOPE_PROCESS     resource competition within process
       detachstate	    PTHREAD_CREATE_JOINABLE   joinable by other threads
       stackaddr	    NULL		      stack allocated by system
       stacksize	    0			      1 or 2 megabyte
       priority 	    0			      priority of the thread
       policy		    SCHED_OTHER 	      traditional time-sharing policy
       inheritsched	    PTHREAD_INHERIT_SCHED     scheduling  policy  and  parameters
						      are  inherited  from  the  creating
						      thread
       guardsize	    PAGESIZE		      size  of	guard area for a thread's
						      created stack

       The pthread_attr_destroy() function destroys a thread attributes object ( attr), which cannot be  reused  until	it  is	reinitialized.	An
       implementation  may  cause  pthread_attr_destroy()  to  set  attr  to  an implementation-dependent invalid value. The behavior of using the
       attribute after it has been destroyed is undefined.

RETURN VALUES

       Upon successful completion, pthread_attr_init() and pthread_attr_destroy() return a value of  0. Otherwise, an error number is returned	to
       indicate the error.

ERRORS

       The  pthread_attr_init() function will fail if:

       ENOMEM	 Insufficient memory exists to initialize the thread attributes object.

       The  pthread_attr_destroy() function may fail if:

       EINVAL	 attr is invalid.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+
       |Standard		     |See standards(5). 	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sysconf(3C),   pthread_attr_getdetachstate(3C),	 pthread_attr_getguardsize(3C),  pthread_attr_getinheritsched(3C),  pthread_attr_getsched-
       param(3C),  pthread_attr_getschedpolicy(3C),   pthread_attr_getscope(3C),   pthread_attr_getstackaddr(3C),   pthread_attr_getstacksize(3C),
       pthread_attr_setdetachstate(3C),     pthread_attr_setguardsize(3C),    pthread_attr_setinheritsched(3C),    pthread_attr_setschedparam(3C),
       pthread_attr_setschedpolicy(3C),  pthread_attr_setscope(3C),  pthread_attr_setstackaddr(3C),  pthread_attr_setstacksize(3C),   pthread_cre-
       ate(3C), attributes(5), standards(5)

SunOS 5.11							    1 Apr 2008						     pthread_attr_init(3C)