tis_rwlock_init(3) [osf1 man page]

tis_rwlock_init(3)					     Library Functions Manual						tis_rwlock_init(3)

NAME

       tis_rwlock_init - Initializes a read-write lock object.

LIBRARY

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

SYNOPSIS

       #include <tis.h>

       int   tis_rwlock_init(
			      tis_rwlock_t   *lock);

STANDARDS

       None

PARAMETERS

       Address of a read-write lock object.

DESCRIPTION

       This routine initializes a read-write lock object.  The routine initializes the tis_rwlock_t structure that holds the object's lock states.

       To destroy a read-write lock object, call the tis_rwlock_destroy(3) routine.

       NOTE:  The  tis read-write lock has no relationship to the Single UNIX Specification, Version 2 (SUSV2, or UNIX98) read-write lock routines
       (pthread_rwlock_init(3), etc).  The tis_rwlock_t type, in particular, cannot be used with the pthread read-write lock functions; nor can  a
       pthread_rwlock_t type be used with the tis read-write lock functions.

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 not a valid read-write lock.  Insufficient memory exists to initialize lock.

ERRORS

       None

RELATED INFORMATION

       Functions:  tis_read_lock(3),  tis_read_trylock(3),  tis_read_unlock(3),  tis_rwlock_destroy(3),  tis_write_lock(3),  tis_write_trylock(3),
       tis_write_unlock(3)

       Manuals: Guide to DECthreads and Programmer's Guide delim off

																tis_rwlock_init(3)

pthread_rwlock_wrlock(3)				     Library Functions Manual					  pthread_rwlock_wrlock(3)

NAME

       pthread_rwlock_wrlock - Acquires a read-write lock for write access.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int   pthread_rwlock_wrlock(
			     pthread_rwlock_t	      *rwlock);

PARAMETERS

       Address of the read-write lock object to acquire for write access.

DESCRIPTION

       This  routine attempts to acquire a read-write lock for write access.  If any thread already has acquired the lock for write access or read
       access, the lock is not granted and the calling thread blocks until it can acquire the lock. A thread can hold  only  one  lock	for  write
       access on a read-write lock.

       Results	are  undefined	if  the  calling  thread  holds the read-write lock (whether for read or write access) at the time this routine is
       called.

       If the read-write lock object referenced by rwlock is not initialized, the results of calling this routine are undefined.

       If a thread is interrupted (via a Tru64 UNIX signal or an OpenVMS AST) while waiting for a read-write lock for write  access,  upon  return
       from the interrupt routine the thread resumes waiting for the lock as if it had not been interrupted.

       Realtime applications can encounter priority inversion when using read-write locks. The problem occurs when a high-priority thread acquires
       a read-write lock that is about to be unlocked (that is, posted) by a low-priority thread, but the low-priority thread is  preempted  by  a
       medium-priority	thread.  This scenario leads to priority inversion in that a high-priority thread is blocked by lower-priority threads for
       an unlimited period of time.  During system design, realtime programmers must take into account the possibility of priority  inversion  and
       can  deal with it in a number of ways, such as by having critical sections that are guarded by read-write locks execute at a high priority,
       so that a thread cannot be preempted while executing in its critical section.

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 current thread already owns the read-write lock for write or read access.	The value specified by rwlock does
       not refer to an initialized read-write lock object.

ERRORS

       None

RELATED INFORMATION

       Functions:      pthread_rwlock_init(3),	    pthread_rwlockattr_init(3),       pthread_rwlock_rdlock(3),       pthread_rwlock_trywrlock(3),
       pthread_rwlock_unlock(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															  pthread_rwlock_wrlock(3)