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 indicating 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)