tis_mutex_lock(3) [osf1 man page]

tis_mutex_lock(3)					     Library Functions Manual						 tis_mutex_lock(3)

NAME

       tis_mutex_lock - Locks an unlocked mutex.

LIBRARY

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

SYNOPSIS

       #include <tis.h>

       int   tis_mutex_lock(
			      pthread_mutex_t	*mutex);

STANDARDS

       None

PARAMETERS

       Address of the mutex (passed by reference) to be locked.

DESCRIPTION

       This  routine  locks  the specified mutex mutex.  A deadlock can result if the current owner of a mutex calls this routine in an attempt to
       lock the same mutex a second time.  (DECthreads does not detect or report the deadlock.)

       In a threaded environment, the thread that has locked a mutex becomes its current owner and remains the owner until  the  same  thread  has
       unlocked it.  This routine returns with the mutex in the locked state and with the current thread as the mutex's current owner.

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.  The value specified by mutex is invalid.  A deadlock condition is detected.

ERRORS

       None

RELATED INFORMATION

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

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

																 tis_mutex_lock(3)

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)