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

tis_mutex_trylock(3)


NAME

  tis_mutex_trylock - Attempts to lock the specified mutex


SYNOPSIS

  #include <tis.h>

  int tis_mutex_trylock(
	  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 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:

  0   Successful completion.

  [EBUSY]
      The mutex is already locked; therefore, it was not acquired.

  [EINVAL]
      The value specified by mutex is invalid.


ERRORS

  None


SEE ALSO

  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

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