pthread_unlock_global_np(3) [osf1 man page]

pthread_unlock_global_np(3)				     Library Functions Manual				       pthread_unlock_global_np(3)

NAME

       pthread_unlock_global_np - Unlocks the DECthreads global mutex.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int   pthread_unlock_global_np(void);

STANDARDS

       None

PARAMETERS

       None

DESCRIPTION

       This  routine  unlocks  the  DECthreads	global	mutex.	 Because  the  global  mutex  is  recursive,  the  unlock occurs when each call to
       pthread_lock_global_np(3) has been matched by a call to this routine.  For example, if you called  pthread_lock_global_np(3)  three  times,
       pthread_unlock_global_np(3) unlocks the global mutex when you call it the third time.

       If  no  threads are waiting for the DECthreads global mutex, it becomes unlocked with no current owner.	If one or more threads are waiting
       to lock the global mutex, this routine causes one thread to unblock and try to acquire the global mutex.  The scheduling policy is used	to
       determine  which  thread is awakened.  For the policies SCHED_FIFO and SCHED_RR, a blocked thread is chosen in priority order, using first-
       in/first-out (FIFO) within priorities.

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 mutex is unlocked or owned by another thread.

ERRORS

       None

RELATED INFORMATION

       Functions: pthread_lock_global_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

														       pthread_unlock_global_np(3)

pthread_lock_global_np(3)				     Library Functions Manual					 pthread_lock_global_np(3)

NAME

       pthread_lock_global_np - Locks the DECthreads global mutex.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread.h>

       int   pthread_lock_global_np(void);

STANDARDS

       None

PARAMETERS

       None

DESCRIPTION

       This  routine locks the DECthreads global mutex.  If the global mutex is currently held by another thread when a thread calls this routine,
       the calling thread waits for the global mutex to become available and then locks it.

       The thread that has locked the global mutex becomes its current owner and remains the owner until the same thread has  unlocked	it.   This
       routine returns with the global mutex in the locked state and with the current thread as the global mutex's current owner.

       Use the DECthreads global mutex when calling a library package that is not designed to run in a multithreaded environment.  Unless the doc-
       umentation for a library function specifically states that it is thread safe, assume that it is not compatible; in other words,	assume	it
       is nonreentrant.

       The  global mutex is one lock.  Any code that calls any function that is not known to be reentrant should use the same lock.  This prevents
       problems resulting from dependencies among threads that call library functions and those functions' calling other functions, and so on.

       The global mutex is a recursive mutex.  A thread that has locked the global mutex can relock it without deadlocking.   The  locking  thread
       must call pthread_unlock_global_np(3) as many times as it called this routine, to allow another thread to lock the global mutex.

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.

ERRORS

       None

RELATED INFORMATION

       Functions: pthread_unlock_global_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															 pthread_lock_global_np(3)