pthread_attr_init(3) [osf1 man page]

pthread_attr_init(3)					     Library Functions Manual					      pthread_attr_init(3)

NAME

       pthread_attr_init - Initializes a thread attributes object.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int pthread_attr_init(
			pthread_attr_t	 *attr,);

STANDARDS

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

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

PARAMETERS

       Address of a thread attributes object to be initialized.

DESCRIPTION

       This  routine  initializes  the	thread	attributes object specified by the attr argument with a set of default attribute values.  A thread
       attributes object is used to specify the attributes of one or more threads when they are created.  The attributes object  created  by  this
       routine is used only in calls to the pthread_create(3) routine.

       The   following	 routines   change   individual  attributes  of  an  initialized  thread  attributes  object:  pthread_attr_setdetachstate
       pthread_attr_setguardsize_np  pthread_attr_setinheritsched  pthread_attr_setschedparam  pthread_attr_setschedpolicy   pthread_attr_setscope
       pthread_attr_setstackaddr pthread_attr_setstacksize

       The  attributes of the thread attributes object are initialized to default values.  The default value of each attribute is discussed in the
       reference description for each routine listed above.

       When a thread attributes object is used to create a thread, the object's attribute values determine the characteristics of the new  thread.
       Thus,  attributes  objects  act as additional arguments to thread creation.  Changing the attributes of a thread attributes object does not
       affect any threads that were previously created using that attributes object.

       You can use the same thread attributes object in successive calls to pthread_create(3), from any thread.  (However, you cannot use the same
       value  of  the stack address attribute to create multiple threads that might run concurrently; threads cannot share a stack.)  If more than
       one thread might change the attributes in a shared attributes object, your program must use  a  mutex  to  protect  the	integrity  of  the
       attributes object's contents.

       When  you  set  the scheduling policy or scheduling parameters, or both, in a thread attributes object, you must disable scheduling inheri-
       tance if you want the scheduling attributes you set to be used at thread creation.  To disable scheduling inheritance, before creating  the
       new thread use the pthread_attr_setinheritsched routine to specify the value PTHREAD_EXPLICIT_SCHED for the inherit argument.

RETURN VALUES

       If an error condition occurs, the thread attributes object cannot be used, and this routine returns an integer value indicating the type of
       error.  Possible return values are as follows: Successful completion.  The value specified by attr is not a valid thread attributes object.
       Insufficient memory exists to initialize the thread attributes object.

ERRORS

       None

RELATED INFORMATION

       Functions:    pthread_attr_destroy(3),	pthread_attr_setdetachstate(3),   pthread_attr_setguardsize(3),   pthread_attr_setinheritsched(3),
       pthread_attr_setschedparam(3), pthread_attr_setschedpolicy(3),  pthread_attr_setscope(3),  pthread_attr_setstackaddr(3),  pthread_attr_set-
       stacksize(3), pthread_create(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															      pthread_attr_init(3)

Check Out this Related Man Page

pthread_attr_init(3C)													     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);

       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	 NULL			   1 or 2 megabyte
       priority 	 0			   priority of the thread
       policy		 SCHED_OTHER		   determined by system
       inheritsched	 PTHREAD_EXPLICIT_SCHED    scheduling  policy  and  parameters
						   not	 inherited   but    explicitly
						   defined by the attribute object
       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.

       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.

       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.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

       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)

								    23 Mar 2005 					     pthread_attr_init(3C)

Linux and UNIX Man Pages

pthread_attr_init(3) [osf1 man page]

Check Out this Related Man Page