tis_read_lock(3) — Subroutines

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

lockAddress 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:

0Successful completion.

[EINVAL]
The value specified by lock is invalid.

ERRORS