Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pthread_mutexattr_init(3c) [sunos man page]

pthread_mutexattr_init(3C)												pthread_mutexattr_init(3C)

pthread_mutexattr_init, pthread_mutexattr_destroy - initialize or destroy mutex attributes object SYNOPSIS
cc -mt [ flag... ] file... -lpthread [ library... ] #include <pthread.h> int pthread_mutexattr_init(pthread_mutexattr_t *attr); int pthread_mutexattr_destroy(pthread_mutexattr_t *attr); The pthread_mutexattr_init() function initializes a mutex attributes object attr with the default value for all of the attributes defined by the implementation. The effect of initializing an already initialized mutex attributes object is undefined. After a mutex attributes object has been used to initialize one or more mutexes, any function affecting the attributes object (including destruction) does not affect any previously initialized mutexes. The pthread_mutexattr_destroy() function destroys a mutex attributes object; the object becomes, in effect, uninitialized. An implementa- tion may cause pthread_mutexattr_destroy() to set the object referenced by attr to an invalid value. A destroyed mutex attributes object can be re-initialized using pthread_mutexattr_init(); the results of otherwise referencing the object after it has been destroyed are undefined. Upon successful completion, pthread_mutexattr_init() and pthread_mutexattr_destroy() return 0. Otherwise, an error number is returned to indicate the error. The pthread_mutexattr_init() function may fail if: ENOMEM Insufficient memory exists to initialize the mutex attributes object. The pthread_mutexattr_destroy() function may fail if: EINVAL The value specified by attr is invalid. See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ pthread_cond_init(3C), pthread_create(3C), pthread_mutex_init(3C), pthread_mutexattr_settype(3C), attributes(5), standards(5) 23 Mar 2005 pthread_mutexattr_init(3C)

Check Out this Related Man Page

pthread_mutexattr_init(3T)												pthread_mutexattr_init(3T)

pthread_mutexattr_init(), pthread_mutexattr_destroy() - initialize or destroy a mutex attributes object SYNOPSIS
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)
Man Page