tis_mutex_lock(3) — Subroutines

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:

0Successful completion.

[EINVAL]
The value specified by mutex is invalid.

[EDEADLK]
A deadlock condition is detected.

ERRORS