pthread_rwlock_trywrlock(3) [osf1 man page]

pthread_rwlock_trywrlock(3)				     Library Functions Manual				       pthread_rwlock_trywrlock(3)

NAME

       pthread_rwlock_trywrlock - Attempts to acquire a read-write lock for write access without waiting.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int   pthread_rwlock_trywrlock(
			     pthread_rwlock_t	      *rwlock);

PARAMETERS

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

DESCRIPTION

       This routine attempts to acquire the read-write lock referenced by rwlock for write access. If any thread already holds that lock for write
       access or read access, this routine fails and returns [EBUSY] and the calling thread does not wait for the lock to become available.

       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.

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

ERRORS

       None

RELATED INFORMATION

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

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

														       pthread_rwlock_trywrlock(3)

pthread_rwlock_wrlock(3C)				   Standard C Library Functions 				 pthread_rwlock_wrlock(3C)

NAME

       pthread_rwlock_wrlock, pthread_rwlock_trywrlock - lock or attempt to lock read-write lock object for writing

SYNOPSIS

       cc -mt [ flag... ] file... -lpthread [ library... ]
       #include <pthread.h>

       int pthread_rwlock_wrlock(pthread_rwlock_t *rwlock);

       int pthread_rwlock_trywrlock(pthread_rwlock_t *rwlock);

DESCRIPTION

       The  pthread_rwlock_wrlock()  function  applies	a  write lock to the read-write lock referenced by rwlock. The calling thread acquires the
       write lock if no other thread (reader or writer) holds the read-write lock rwlock. Otherwise, the thread blocks until it  can  acquire  the
       lock.

       The  pthread_rwlock_trywrlock()	function applies a write lock like the pthread_rwlock_wrlock() function, with the exception that the func-
       tion fails if any thread currently holds rwlock (for reading or writing).

       Writers are favored over readers of the same priority to avoid writer starvation. See pthread_rwlock_rdlock(3C).

       Results are undefined if any of these functions are called with an uninitialized read-write lock.

       If a signal is delivered to a thread waiting for a read-write lock for writing, upon return from the  signal  handler  the  thread  resumes
       waiting for the read-write lock for writing as if it was not interrupted.

RETURN VALUES

       If successful, the pthread_rwlock_wrlock() function returns 0. Otherwise, an error number is returned to indicate the error.

       The  pthread_rwlock_trywrlock()	function returns 0 if the lock for writing on the read-write lock object referenced by rwlock is acquired.
       Otherwise an error number is returned to indicate the error.

ERRORS

       The pthread_rwlock_wrlock() function will fail if:

       EDEADLK	  The current thread already owns the read-write lock for writing or reading.

       The pthread_rwlock_trywrlock() function will fail if:

       EBUSY	The read-write lock could not be acquired for writing because it was already locked for reading or writing.

ATTRIBUTES

       See  attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       pthread_rwlock_init(3C), pthread_rwlock_unlock(3C), pthread_rwlockattr_init(3C), pthread_rwlock_rdlock(3C), attributes(5), standards(5)

SunOS 5.11							    23 Mar 2005 					 pthread_rwlock_wrlock(3C)