pthread_mutexattr_destroy(3t) [hpux man page]

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)

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_destroy(3t) [hpux man page]

Check Out this Related Man Page