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)