pthread_mutexattr_init(3c) [opensolaris man page]

pthread_mutexattr_init(3C)				   Standard C Library Functions 				pthread_mutexattr_init(3C)

NAME

       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);

DESCRIPTION

       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.

RETURN VALUES

       Upon successful completion, pthread_mutexattr_init() and pthread_mutexattr_destroy() return 0. Otherwise, an error number  is  returned	to
       indicate the error.

ERRORS

       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.

ATTRIBUTES

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

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

SEE ALSO

       pthread_cond_init(3C), pthread_create(3C), pthread_mutex_init(3C), pthread_mutexattr_settype(3C), attributes(5), standards(5)

SunOS 5.11							    23 Mar 2005 					pthread_mutexattr_init(3C)

Check Out this Related Man Page

pthread_mutexattr_init(3)				     Library Functions Manual					 pthread_mutexattr_init(3)

NAME

       pthread_mutexattr_init - Initializes a mutex attributes object.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int   pthread_mutexattr_init(
			      pthread_mutexattr_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 the mutex attributes object to be initialized.

DESCRIPTION

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

       When  a mutex attributes object is used to create a mutex, the values of the individual attributes determine the characteristics of the new
       mutex.  Thus, attributes objects act as additional arguments to mutex creation.	Changing individual attributes	in  an	attributes  object
       does not affect any mutexes that were previously created using that attributes object.

       You can use the same mutex attributes object in successive calls to pthread_mutex_init(3), from any thread.  If multiple threads can change
       attributes in a shared mutex attributes object, your program must use a mutex to protect the integrity of the attributes object's contents.

       Results are undefined if this routine is called and the attr argument specifies a mutex attributes object that is already initialized.

RETURN VALUES

       If an error condition occurs, this routine returns an integer value indicating the type of error.  Possible return values are  as  follows:
       Successful completion.  Insufficient memory to create the mutex attributes object.

ERRORS

       None

RELATED INFORMATION

       Functions: pthread_mutexattr_destroy(3), pthread_mutexattr_gettype(3), pthread_mutexattr_settype(3), pthread_mutex_init(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															 pthread_mutexattr_init(3)

Linux and UNIX Man Pages

pthread_mutexattr_init(3c) [opensolaris man page]

Check Out this Related Man Page