Content-type: text/html Man page of tis_read_lock

tis_read_lock

Section: C Library Functions (3)
Index Return to Main Contents
 

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

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: Successful completion. 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 delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:32 GMT, October 02, 2010