Manual Page Result
0
Command: tis_mutex_trylock | Section: 3 | Source: Digital UNIX | File: tis_mutex_trylock.3.gz
tis_mutex_trylock(3) Library Functions Manual tis_mutex_trylock(3)
NAME
tis_mutex_trylock - Attempts to lock the specified mutex.
LIBRARY
Standard C Library (libc.so, libc.a)
SYNOPSIS
#include <tis.h>
int tis_mutex_trylock(
pthread_mutex_t *mutex);
STANDARDS
None
PARAMETERS
Address of the mutex (passed by reference) to be locked.
DESCRIPTION
This routine attempts to lock the specified mutex mutex. When this
routine is called, an attempt is made immediately to lock the mutex.
If the mutex is successfully locked, zero (0) is returned.
If the specified mutex is already locked when this routine is called,
the caller does not wait for the mutex to become available. [EBUSY] is
returned, and the thread does not wait to acquire the lock.
RETURN VALUES
If an error condition occurs, this routine returns an integer value in-
dicating the type of error. Possible return values are as follows:
Successful completion. The mutex is already locked; therefore, it was
not acquired. The value specified by mutex is invalid.
ERRORS
None
RELATED INFORMATION
Functions: tis_mutex_destroy(3), tis_mutex_init(3), tis_mutex_lock(3),
tis_mutex_unlock(3)
Manuals: Guide to DECthreads and Programmer's Guide
delim off
tis_mutex_trylock(3)