tis_mutex_init - Initializes a mutex object
pthread_mutex_t *mutex );
Standard C Library (libc.so, libc.a)
Pointer to a mutex object (passed by reference) to be initialized.
This routine initializes a mutex object with the DECthreads
default mutex attributes. A mutex is a synchronization
object that allows multiple 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 initialization 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
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.
Functions: tis_mutex_destroy(3), tis_mutex_lock(3),
Manuals: Guide to DECthreads and Programmer's Guide
[ Back ]