tis_mutex_init(3) [osf1 man page]

tis_mutex_init(3)					     Library Functions Manual						 tis_mutex_init(3)

NAME

       tis_mutex_init - Initializes a mutex object.

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <tis.h>

       int   tis_mutex_init(
			     pthread_mutex_t   *mutex);

STANDARDS

       None

PARAMETERS

       Pointer to a mutex object (passed by reference) to be initialized.

DESCRIPTION

       This routine initializes a mutex object with the DECthreads default mutex attributes.  A mutex is a synchronization object that allows mul-
       tiple threads to serialize their access to shared data. The mutex is initialized and set to an unlocked state.

       Your program can use the PTHREAD_MUTEX_INITIALIZER macro to statically initialize a mutex object without calling this routine.  Static ini-
       tialization  can be used only for a condition variable with class extern or static - automatic (stack local) objects must be initialized by
       calling tis_mutex_init(3).  Use this macro as follows:

       pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER

RETURN VALUES

       If an error condition occurs, this routine returns an integer value indicating the type of error, the mutex is  not  initialized,  and  the
       contents  of  mutex are undefined.  Possible return values are as follows: Successful completion.  The system lacks the necessary resources
       to initialize a mutex.  The implementation has detected an attempt to reinitialize mutex (a previously initialized, but not  yet  destroyed
       mutex).	 The value specified by mutex is not a valid mutex.  Insufficient memory exists to initialize the mutex.  The caller does not have
       privileges to perform this operation.

ERRORS

       None

RELATED INFORMATION

       Functions: tis_mutex_destroy(3), tis_mutex_lock(3), tis_mutex_trylock(3), tis_mutex_unlock(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

																 tis_mutex_init(3)

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)