pthread_mutexattr_init(3T)												pthread_mutexattr_init(3T)

NAME

       pthread_mutexattr_init(), pthread_mutexattr_destroy() - initialize or destroy a mutex attributes object

SYNOPSIS

PARAMETERS

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

DESCRIPTION

       initializes the mutex attributes object attr with the default values for all attributes.  The attributes object describes a mutex in detail
       and is passed to the mutex initialization function.

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

       When a mutex is initialized with an attributes object, the attributes are, in effect, copied into the mutex.  Consequently, any	change	to
       the  attributes object will not affect any previously initialized mutexes.  Once all mutexes needing a specific attributes object have been
       initialized, the attributes object is no longer needed.

       The mutex attributes and their default values are:

	      The default value is

	      The default value is

       If an initialized mutex attributes object is reinitialized, undefined behavior results.

       destroys the mutex attributes object attr.  The destroyed mutex attributes object ceases to exist and its resources  are  reclaimed.  Using
       attr  after  it has been destroyed results in undefined behavior.  A destroyed mutex attributes object can be reinitialized using the func-
       tion.

       Mutexes that have been already initialized using this attributes object are not affected by the destruction of the mutex 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

       For each of the following conditions, if the condition is detected, the and functions return the corresponding error number:

	      [ENOMEM]	     There is insufficient memory available in which to initialize attr.

	      [EINVAL]	     The value specified by attr is invalid.

AUTHOR

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

SEE ALSO

       pthread_create(3T),  pthread_mutexattr_getpshared(3T),  pthread_mutexattr_setpshared(3T),   pthread_mutexattr_gettype(3T),   pthread_mutex-
       attr_settype(3T), pthread_mutex_init(3T).

STANDARDS CONFORMANCE

								  Pthread Library					pthread_mutexattr_init(3T)