Index Index for
Section 3
Index Alphabetical
listing for T
Bottom of page Bottom of
page

tis_mutex_lock(3)

NAME

tis_mutex_lock - Locks an unlocked mutex

SYNOPSIS

#include <tis.h> int tis_mutex_lock( pthread_mutex_t *mutex );

LIBRARY

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

STANDARDS

None

PARAMETERS

mutex 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: 0 Successful completion. [EINVAL] The value specified by mutex is invalid. [EDEADLK] A deadlock condition is detected.

ERRORS

None

SEE ALSO

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

Index Index for
Section 3
Index Alphabetical
listing for T
Top of page Top of
page