tis_read_lock(3)

Index for
Section 3
Alphabetical
listing for T
Bottom of
page
tis_read_lock(3)
NAME
  tis_read_lock - Acquires a read-write lock for read access.

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

SYNOPSIS
  #include <tis.h>

  int	tis_read_lock(
			 tis_rwlock_t	*lock);

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

RELATED INFORMATION
  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 for
Section 3
Alphabetical
listing for T
Top of
page