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

tis_read_lock(3)


NAME

  tis_read_lock - Acquires a read-write lock for read access


SYNOPSIS

  #include <tis.h>

  int tis_read_lock(
	  tis_rwlock_t *lock );


LIBRARY

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


STANDARDS

  None


PARAMETERS

  lock
      Address of the read-write lock.


DESCRIPTION

  This routine acquires a read-write lock for read access. This routine waits
  for any existing lock holder for write access to relinquish its lock before
  granting the lock for read access.  This routine returns when the lock is
  acquired. If the lock is already held for read access, the lock is granted.

  For each call to tis_read_lock(3) that successfully acquires the lock for
  read access, a corresponding call to tis_read_unlock(3) must be issued.

  Note that the type tis_rwlock_p is a pointer to type tis_rwlock_t.


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 lock is invalid.


ERRORS

  None


SEE ALSO

  Functions: tis_read_trylock(3), tis_read_unlock(3), tis_rwlock_destroy(3),
  tis_rwlock_init(3), tis_write_lock(3), tis_write_trylock(3),
  tis_write_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