tis_mutex_init(3)tis_mutex_init(3)NAMEtis_mutex_init - Initializes a mutex object
SYNOPSIS
#include <tis.h>
int tis_mutex_init(
pthread_mutex_t *mutex );
LIBRARY
Standard C Library (libc.so, libc.a)
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 initial‐
ization 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. Insuffi‐
cient memory exists to initialize the mutex. The caller does not have
privileges to perform this operation.
ERRORS
None
SEE ALSO
Functions: tis_mutex_destroy(3), tis_mutex_lock(3), tis_mutex_try‐
lock(3), tis_mutex_unlock(3)
Manuals: Guide to DECthreads and Programmer's Guide
tis_mutex_init(3)